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The Apollo DOMAIN Engine ering Handbook contains syston information 
for the Apollo DOIAIN nodes and related peripherals. Tliis manual 
is for i^llo personnel only. 



Audience 

This guide is for Apollo employees. 

structure of Slis. PPCVment 

Tliis manual contains 8 chapters and two appendices. 

Chapter 1 describes principal control blocks associated with 
memory and process management. 

Qiapter 2 describes hardware architecture of Apollo nodes; basic 
processor and Memory Management Unit (MMU) . 

Oiapter 3 describes display hardware including display boards, 
control and status registers, and BLT registers. 

Chapter 4 describes all syston (status) error codes and messages. 

Chapter 5 describes formats of file objects. 

Chapter 6 describes characteristics of peripiieral I/O devices; 
format of control registers and I/O commands. 

Chapter 7 describes miscellaneous information useful to those 
programming in the DCMAIN environment. 

Chapter 8 describes syston debugging tools, including the mnemonic 
debugger, extensions to the HLL debugger, and system dumps. 

Appendix A describes the ASCII character set. 

Af^ndix B is a powers of two table. 

Pelate<a Ppcuments 

For information about systen calls, see Apollo System Programmer's 
Reference Manual 

For information about perijAieral driver routines, see GPIQ User*s 
Guide . 

For Shell and DM commands see, dqmm:n jgyistem Comnend Reference 
Maniial . 
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Co n ven t ions 



Symbol Meaning 

+00 Offset, in hexadecimal 

Unused bit 

Range of unused bits 

.... Continuation 
..Itame Name for this field 
N = 1 => If bit N is set, then ... 
N..N All bits labeled N 
=> Implies 

— > Pointer to 
-> Pointer to 

Pointer to 
set of 0..31 32 bits 
1..32 32 values; 5 bits 
<a> Variable 

[pa I va] Physical address | Virtual address 
UPPERCASE Uppercase words -> literal commands or keywords 
lowercase Lowercase words => command values that you must 

supply 
[ ] Square brackets enclose optional itens in formats and 

commands 
{ } Braces enclose a list from which you must choose an 

item in formats and comnand descriptions. 
I A vertical bar separates itens in a list of choices 
< > Angle brackets enclose the name of a key on the 
ke^iDoard 
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CHAPTER 1 
AEGIS 



AEGIS SYSTEM RELATIONSHIPS 



f 



COMMANDS 

FILES 

PERIPHERALS 



NAME SERVER 



PATHNAME ' UID 

I 96 BIT ADDRESS 



PHYSICAL 

MEMORY 
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ACTIVE SECTIEyrr TABLE (AST^ 

AST: ARRAY[1..64] OF ASTE_T 
ACTIVE SEGMENT TABLE ENTRY (ASTE) 
(type "aste_t" in vm. ins. pas) 



+08 
+0C 
+10 
+14 
+18 
+1C 
+20 



+B0 
CC 
P 
I 
F 
T 

H..H 
F 

D..D 
G 

V..V 
D 
R 
N..N 



UK) OF FILE TO WHICH 
SEGMENT BELONGS 



FILE SEGMENT NUM. | AST HASH LINK 



-CCPIF~I THHHHl POIOTER TO . . . | 



. . . VTOC ENTRY | POINTER TO . . . I 



. . . FILE MAP EISTTRY | SYS TYPE | FDDDDDDD | 



CURRENT LENGTH | GWW | DRNNNNNN | 



DATE-TIME MODIFIED (CL0CK_HIGH32) I 



PAGE MAP 

-or- 
FILE MAP 



.f segno, 
.link 
.vtoce_addr 

.fm addr 

.sys_type 

.cur_len 

.dtm 

.tYpe_uid 

.acl_uid 

.pmap[1..32] 

.praap_fin 

[1..32] 



Concurrency control from VTOC entry (.con_ctrl) 

Permanent segment (.permanent) 

Immutable segment (.immutable) 

File trouble (file_trouble) 

In transition (.in_trans) 

ASTE hold count (.ehcnt) 

File-map modified (.fm_mod) 

Blocks added to seg since active (.blocks_delta) 

Global transparent mode sw: no dtm (.gtms) 

Index in DVT (.volx) 

DTM needs updating (.dtm_fl) 

Grace flag (.gracef) 

Number of pages resident (.npr) 



The AST is a wired system-^ide table that describes the 
current state of active segments. Each ASTE has enough 
information to identify the file segment and the location 
of each page of the segment. All virtual segments mapped 
to the same file segment will use the same ASTE oitry. The 
ASTE acts as a cache of the VTOC entry. 
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+00 I 



HASH TABLE 
START POINTERS 



I .hashtb[0..60] 

+ 
I 

/ 
I 



+7A I ASTE FREE LIST 

H 

+7E I ^DDDl 



ASTE REPLACE PTR| .free, .Iru 



+80 I 



PROCESSES PER 
VOLUME 



I .vitLcnt[1..4] 



+88 I 
+8C I 



COUNTS MDDS TO HASH TABLE 



I .seqjium 



NUMBER OF DISMOUNTS 



+90 I 



EVENT COUNT FOR 
DISMOUNTER 



+ .disnu^eqn 
-+ 
I .vrruec 

I 



+9C I GRACE RPLC PTR | .Irug 

+9E + + 

DDDD - Disirount request flags (.dnureq) 
(bit 16 = volume 1) 



APOLLO CONFIDENTIAL. INTERNAL USE ONLY. 



BOOT SHELL OOMMANDS 



CF 

CHN 

CPD 

CRF 

CBL 

CTNODE 

CrOB 

DEBUG 

DLF 

DLL 

DMTVDL 

EX 

GLOB 

H 

IN 



LD 
LI 
LO 

MA 

MTVDL 

ND 

RE 

REL 

SA 

SB 

SHUT 
OTCODE 



[<pathnaine> I -E] 

<pathnaine> <con5)naiTie> 

<pathnaine> 

<pathnaiiie> 

<pathnaine> <linknaine> 

<leaf> <node_id> 

<pathname> <uidhi> <uidlo> 

<value> 

<pathnaine> 

<linknaine> 



run/end command file 

change name 

create directory 

create file 

add link 

add node to local copy of root 

catalog name with specified 

liid 

enable/disable debug mode 

delete file 

drop linkname 

{W I S I F} <lvno> [<pathname>] dismount a logical volume 
<pathname> execute (rfc) file 

list installed globals 

prints this text 
<pathname> [-D] [-S I -NS] invoke loader to install named 

file 
[-U] list directory 

set display lites address 
-NS] invoke the loader w/ the given 

OFC file 

map file 



[<pathname>] [-A [-D] ] 
<address> 
<pathname> [-D] [-S I 



<pathname> [<1> <sz>] [-E] 

{W I S I F} <lvno> [<pathname>] mount a logical volume 



TB 
TI 
TR 

UCTNDDE 

UCrOB 

UMA 

WD 

Key: 



<pathname> 
<pathname> 
[-A] 

<pathname> [<1> <h> <s>] 

<pathname> [<1> <h>] 

<status-code> 

{-ON I -OFF} 
<pathname> <sz> 

<leaf> 

<pathname> 

{<pathname> I <1> <sz>} 

<pathname> 



set naming directory 
restore file into static mem 
release proc-mgr assigned 
storage 

save file given lo, hi, start 
addrs 

save raw data file given lo, 
hi addrs 
shutdown system 
print textual definition of 
status code 
stack trace back 
enable/disable timer 
truncate raw data file to 
given size (hex) 
drop node from local copy of 
root 

un-catalog pathname from 
namespace 

unitap file by name or 
addr/size 
set working directory 



<1> 

<h> 

<s> 

<sz> 

<type> 



low address 
high address 
start address 
size 

{ nil, rec, hdru, obj, 
boot } 



dev, pad, undef, mt. 
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QjQCK 



(type "clock_t" in base. ins. pas) 

|< .high >|<- -.10- • 

47 33 32 16 15 



-+- 



I 



+- 



-+- 



-+- 



I<- .highie- ->|< - .low32 >| 

Low-order bit represents 4 microseconds. 

Hardware clock is only 16 bits. Upper 32 bits are 
itaintained by clock interrupt routine. There are 3 
hardware clocks (not counting calendar clock) : 



Clock 1 
Clock 2 
Clock 3 



4 microseconds (real-time clock) 
8 microseconds (process timer) 
128 microseconds (real-time intervals) 



msK m>fPRnT.T.CT? tart.f: fi^jtry 



(type dcte_t in io. ins. pas) 
31 



+00 
+04 
+08 
-KX: 
+10 
+14 

+20 

+24 

+28 
+2C 



CONTROLLER TYP] CONTROLLER # 



CONTROLLER STATOS 



MOTEX LOCK I lOMAP BASE 



BLOCK HEADER POINTER 



I/O REGISTER PAGE POINTER 



EVENTOOUOT 



PAGE ZERO lOTERHJPT VECTOR 



ACTUAL lOTERPUPT EITTRY 



DEV DEPENDENT IMTERRUPT RTN 



.ctype, ,cnum 

.cstatus 

.lock_no, .iomapjDase 

.blk_hdr_ptr 

.csrs_ptr 

.int_ec 

.vector__ptr 
. int_entry 
. int_routine 
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DISK VOLUME TART.K TWTRY 



(type dvte_t in disk. pvt. pas) 
31 



+00 I 

+- 
+04 I 



DCTE ... I .state, .dcte 
DISK UNIT # I .unit 



BLOCKS ... I .dtype, 

-+ .blocks_per_vol 



+08 I DISK TYPE 

40C I ... PER PVOL I BLKS / TRACK | .blocks_per_ track. 



+10 i TI^CKS / CYL I CURRENT CYL | .tracks_per_cyl, 

H 1. (. .current_cyl 

+14 I MOUNTING PROCI BASE DADDR | .ovmer_proc, .lv_base 

H + 1- 

+18 I . . . I I .uid 

+ h + 

+1C I UID OF PV OR LV | 

+ H h 

+20 I I DEVICE STATUS I .flags 



state: 



free 

being_mounted 
assigned 
nounted 



flags : wr ite_ protect 



EVENT oouyrr 



(type eventcount_t of base. ins. pas) 



CURRENT EC VALUE 



+4 I NEXT PROCESS 



+8 I PREVIOUS PROCESS 



.value 
.nnext 
.nprev 



(type ecnode_t of base. in. pas) 



+0 I CURRENT EC VALUE 

H 

+4 I NEXT PROCESS 



+8 I PREVIOUS PROCESS 



+C iPCB OF WAITING PROC 



.value 
.nnext 
.nprev 
.pcb 



APOLLO CONFIDENTIAL INTERNAL USE ONLY. 



FAULT DIAGN3STIC RECORD 

(type "fault_$diag_t" in fault. ins. pas) 
15 

.pattern (#DFDF) 



+00 
+02 



/ REGISTESRS / 



1101111111011111 



STATUS 
WORD 



ACCESS 
ADDRESS 



INST. REGISTER 



PIVA- 



— > SUPERVISOR 

ECB 
SUPERVISOR SR 



SUPERVISOR 
PC 



SR AT FAULT 



PC AT 
FAULT 



.Status 



.registers 



} .bus_info 

} 

} .access_address 

} ( f aul t_$bus_inf o_t ) 



. inst__register 



.sup_ecb 



+46 
+48 

+4C 
+4E 
+50 

+54 
+56 

+5A 
+5C 

+60 

R - Read operation (.write^op) 

N - Not instruction reference (.notjnst) 

FFF - Instruction function code (.function_code) : 

001 User data 

010 User program 

101 Supervisor data 

110 Supervisor program 

111 Interrupt acknowledge 

P - Permit return from fault (.return_permitted) 

I - In supervisor (.irusupervisor) 

V - Registers valid (.registers_valid) 

A - AB valid (fault_$bus_info_t is valid) (.ab_valid) 



.sup_ 


_sr 




.suipjpc 




.sr 


(user 


sr) 


.pc 


(user 


pc) 



I 
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MAPPED SEGMENT TABLE (MST) 

MST: AI?EAY[0.. 15,0. .319] OF MSTE 

MAPPED SEGMEOT TABLE ENTRY (MSTE) : 
(type "mste" in vm. ins. pas) 



+00 I 



UK) OF FILE 



+08 I FILE SEGMENT # | EAAAAAGPPPPPPPPP 



+0C I INDEX OF VTOC ENTRY (VTOCX) 
+10 H 



.uid 
.f segno 
.locx 



E = 1 => File extension allowed (.ext_ok) 
AAAAA - Access (.access): 

00000 Nil (access_$nil) 

00010 Read (access_$r) 

00011 Read-execute (access_$rx) 

00110 Write-read (acce§s_$wr) 

00111 Write-read-execute (access_$wrx) 

10010 Supervisor read (access_$sr) 

10011 Supervisor read-execute (access_$srx) 

10110 Supervisor write-read (access_$swr) 

10111 Supervisor write-read-execute (access_$swrx) 
G = 1 => Interrrupt on ref (.guard) 

P - Probable ASTEX (.pastex) 

The MST is a wired per-process table describing the 
process's address space. Each entry represents one virtual 
memory segment and describes the object to viiich this 
segment is napped. 
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MEMORY MAP (MMAP) 



31 



+00 I MMAPE, page 

H • 

+04 I MMAPE, page 1 



+4*ppn I MMAPE, page ppn 



The MMAP is a systen-wide table describing the cx)ntents of 
physical memory. There is one entry per i^ysical page of 
memory. 



MEMORY MAP EtTTRY (MMAPE) 

(type "mmape" in mmap.pvt.pas) 



31 



24 23 16 15 



|IANMPRAA|AAAAAAAA|DDDDDDPP|PPPPPPPP| (page in use) 



100- 



-I- 



-|T.r.T.r.T.T.T.T,|T,T.T.T,T,T,T.r,| (free entry) 



-+- 



-+- 



I = 1 => Entry in use (.inuse) 

A - False if page wired or in transit (.avail) 

N = 1 => No copy on disk (.null) 

M - Page mod'ed but dtm shouldn't be updated (.rmod) 

P = 1 => Purifier used (.usedp) 

R = 1 => Replacer used (.usedr) 

A. .A - ASTE index (.astex) 

D..D - Disk addr high (.daddrjh) 

P..P - PTT index (.pttx) 

S..S - Segment page nuntoer (.mspgno) 

L..L - Link to next free MMAP entry (.link) 

L..L*4 to get displaceitfent in table of next entry 



00 Free page or permanent non-file system (e.g., PROM). 

01 Not used. 

10 Page not available for paging out. 

11 Page is available — purifier & replacer will 
look at it. 
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OS MAPPING 



PER 

PROCESS 

SUPERVISOR 



PER 

PROCESS 

USER 



SINGLE MODE 
PROCESS 

VIRTUAL ADDRESS 
SPACE 




NETWORK 
GLOBAL 
OBJECT SPACE 
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PAGE MAP 



PMAP: ARRAY [0.. 31] OF PMAPE (IN ASTE T) 

PAGE MAP EtTTRY: 

(type "pmape" in vm. ins. pas) 



IWWIRl PPN I DISK ADDR LOW 



(resident page) 



FULL DISK ADDR 



(non-resident page) 



WW - Wired count (.wired) 

I - Page in transition (.in_trans) 

R - Page resident (.resident) 

A page nap lives in an AST entry. If resident, the 
high-order bits of the disk address are in the MMAP entry 
for the page. 



PAGING SYSTEM 
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PROCESS OONTRQL BLOCK fPCB) 

(type "procl_t" in PRDCl.PAS) 

31 

+00 



+04 
+08 
-HX 
+10 
+14 
+18 

+20 
+24 



— > NEXT READY PCB 



— > PREV REfiDY PCB 



-> SUPERVISOR STACK 



RESOURCE lOCK WORD 



T.S. RM.*8MIC|FLPT.PR0C.TYPE 



CPU TIME (clock_t) 



I 



ATOMIC OP CMTi STATE: TBPSW 



CIjOCKH_^T AT START OF EC_$WAIT 



.nextp 

.prevp 

.stack 

.inypid, .as id 

.rlock 

.slice, 

.fpp_tYpe 
} .cpu_total 
} .account 
} .priority 

.atomic_op_count , 

.state 
.wait_start 



State: T - Time slice end with rlock <> [] (tse_onb) 
B - Bound (bound) 

P - Suspension pending (suspjending) 
S - Suspended (suspended) 
W - Waiting (waiting) 



procl_$state_t = SET OF (waiting, suspended, susp_pending, 
bound, tse_onb) ; 

(State is type "procl_$state__t" in procl.ins.pas) 
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mi ASID Description 

1 1 Initial user prcKiess and DM 

2 Null process 

3 Clock process 

4 Page purifier 

5 Network-receive server 

6 Network-paging server 

7 Network-general server 

8 Terminal helper 

9 2 First user process 

10 3 Second user process 

11 4 

12 5 

13 6 

14 7 

22 15 Last user process 

Note: Processes vdiose AS ID is run entirely in global 
space. 

Note: If the debugger's lights command has been given, 
there will be a Lights process with id 9 or greater 
with a ASID. 
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RI^ PACKET PQRMAT 

Message Hea<3er 



< 8 bits- 




— > 


H To Address 


byte 3 
byte 2 
byte 1 
byte 




H Type Field 


byte 1 
byte 




I I 


1 Early ACK | 


H From Address 


byte 3 
byte 2 
byte 1 
byte 




1 Header Data - 

H 


1012 bytes 
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Type Field 
15 



T I T 



iT|T|T|T|T|T|T|T 



Bit 15 - BST - Broadcast - This bit is set in a packet 
intended to be broadcast to all receivers. 
If it is set, the To Address field is ignored. 

Bit 14 thru - T - Type - This field is used to determine 
whether a packet is to be received. 
Each 1 bit in the received Type field is 
compared to the corresponding bit in the 
controller Type register. If any bit 
selected in the Type register is a 1, 
the message is received. If all bits 
selected in the Type register are 0, 
the message is ignored . The APOLLO I 
only irrplements Bits 14 through 8, Bit 7 
through never match. 
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Early ACK Field 

The Early Acknowledge field is inserted by the 
transmitter and modified by the receivers. For the 
purposes of the CRC calculation the early ACK field is 
treated as if it is a byte of O's. This is to allow 
receivers to modify the ACK field without having to 
recompute the CRC checksum. 



I I X I X I I ICP I X I PAR I I 

H — H + (. ^. + 1 1_. 1- 

Bit 7 -0 - This bit is inserted to prevent the rennaining 
bits in the late acknowledge byte from 
being modified by the bit stuffing 
protocol. 

Bit 6 - X - Don't care - This bit is not used. 

Bit 5 - X - Don't care - This bit is not used. 

Bit 4 - - This bit is inserted to prevent the remaining 
bits in the late acknowledge byte from 
being modified by the bit stuffing 
protocol . 

Bit 3 - ICP - Intend to Copy - This bit is set by an 
addressed receiver if it was set up to copy a 
message and the type field matched. A NAK 
(negative acknowledge) condition is indicated 
when no receiver sets this bit. 

Bit 2 - X - Don't care - This bit is not used. 

Bit 1 - PAR - Parity - This parity bit is set so that there 
are an odd number of bits in the late 
acknowledge byte. 

Bit - - This bit is inserted to prevent the remaining 
bits in the late acknowledge byte from 
being modified by the bit stuffing 
protocol. 
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Message Data 
< 



i Message Data - 1024 bytes 



I 



The Message Data field may vary in length from to 
1024 bytes but must always be an even nun±>er of bytes (on 
the Apollo I the controller always uses word DMA) . The 
contents of Message Data field is determined by the 
software, it is transmitted verbatim. 



RPSQWCE LOCK 




networ k_$serv_JLock , 


00 1 } 


mt $lock. 


01 2 } 


ml $free3. 


02 4 } 


ml_$free4, 


03 8 } 


ml_$free5. 


04 10 } 


file_$lockUock, 


05 20 } 


ec2_$lock. 


06 40 } 


smd_$respond_J.ock , 


07 80 } 


smd_$request_lock , 


08 100 } 


disk_$mnt_lock. 


09 200 } 


tentL_$lock, 


10 400 } 


procl_$create_lock , 


11 800 } 


onb_$lock. 


12 1000 faulted to CHB } 


bok_$lock, 


13 2000 runnable on B } 


vtuid_$lock. 


14 4000 } 


vtoc $lock. 


15 8000 } 


bat_$lock, 


16 10000 } 


ast_$lock , 


17 20000 } 


pag_$lock. 


18 40000 } 


ml_$free6. 


19 80000 } 


flp_$lock, 


20 100000 } 


win_$lock , 


21 200000 } 


ring_$xmit lock. 


22 400000 } 


ml_$free7. 


23 800000 } 




the next two locks are highest} 


time_$proc_lock , 


24 1000000 clock process only } 


tiine_$lock 


25 2000000 clock process data base } 
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1-17 



STACK FRAME 



SP --> 


Automatic 
Storage 


I 
1 
1 
1 


SB — > +00 


Caller's SB i 


+04 


— > ECB I 


+08 


(unit list) 1 


+0C 


Caller's DB 1 


+10 


PC for Return ! 


+14 


— > ARGl 1 


+18 


— > ARG2 1 


/ 


f 


1 
/ 


+10+4*n 


— > ARGn 1 






1 
1 



I 

V 
PREVIOUS 
STACK FRAME 



Caller's DB is an optional field. 'DB not saved' bit in 
ECB signals that it is not present. 



STATUS mm 

("status_t" in base. ins. pas) 
31 24 23 16 15 



+- 



-+- 



-+- 



I FSSSSSSS I AMMMMMMM | CCCCCCCCCCCCCCCC | 

H + H + 

F = 1 => module couldn't handle error (.fail) 

S..S - Subsysten identification (.subsys) 

A = 1 => asynchronous fault; only set during delivery 

of fault (.async) 
M..M - Module identification (.module) 
C.C - Module-specific error code (.code) 

See also CHAPTER 4 ERROR CODES. 
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SY STEM DIRECTORIEg 



/aux AUX (UNIX) (optional) 

A>scom Boot shell command directory 

/cc C compiler (optional) 

/com Shell commands directory 

/core Core graphics (optional) 

/dev Peripheral I/O device definitions 

/ftn Fortran (optional) 

/gpio General Purpose I/O (optional) 

/install Installation scripts directory 

/lib System libraries directory 

/pas Pascal (optional) 

Stand-alone utilities directory 
Stand-alone utilities directory 
Stand-alone utilities directory 



/sau 
/saul 
/sau2 
/sys 

/sys/boot 

/sys/cdict 

/sys/dict 

/sys/dictdx 

/sys/dm 

/sys/dmenv 

/sys/dii\/fonts 

/sys/env 

/sys/help 

/sys/ins 

/sys/node_data [ .nn] 

/sys/str eam_$sf cbs 
/sysboot 
/systest 



Boot shell file 

Dictionary for FSERR command 

Dictionary for FSERR command 

Index for dictionary 

Display manager programs 

Command to invoke display manager 

Display manager font definitions 

Software tools environment (no dm) 

Help text files 

User insert files 

Per node read/write data files 

Stream mgr control blocks 

Syston boot file 

On-line system tests directory 



i:rap oqdes 


1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 



SVC — arguments 
SVC — 1 arguments 
SVC — 2 arguments 
SVC — 3 arguments 
SVC — 4 arguments 

SVC — any number of arguments 

Undefined (reflected to user space) 

Undefined (reflected to user space) 

Undefined (reflected to user space) 

Undefined (reflected to user space) 

Undefined (reflected to user space) 

Undefined (reflected to user space) 

Undefined (reflected to user space) 

Undefined (reflected to user space) 
Software-generated fault (pfm_$error_trap) 
Undefined (traps to PROM debugger) 
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CHAPTER 2 
CPU AND MEMORY 



Three of the tables in this chapter — Addressing Modes, Condition 
Codes, and Conditional Tests — are extracted from the MC68000 
16-Bit Microprocessor User's Manual . Second Edition. (Austin, 
Texas: Motorola Semiconductor Products, January 1980). 



ADDRESS SPACE 



DN300 



v irt ua l 



100400 traps 







400 prom 


400->7FFF (one-to-one) 


100800 phys mem 


100800->FFFFF 




700000 ptt 


700000->7FFFFF 




100000 md stk,data 


EOOOOO 




20000 displ mem 


FCOOOO->FDFFFF 




9400 disp 1 


FF9800 




9800 ring 2 


FF9C00 




9000 dma ctl 


FFAOOO 




9C00 flp,win,cal 


FFA800 




8800 timers 


FFACOO 




8400 sios 


FFBOOO 




8000 mmu 


FFB400 




4000 pft 


FFB800->FFC7FF 




5000 big pft 


FPC800->FFF7FF 





APOLLO CONFIDENTIAL INTERNAL USE ONLY. 



CPU and MEMORY 



DN4XX and DN600 



jAiysical 




100400 traps 





400 prom 


400 (one-to-one 


80000 phys mem 


80000->FFFFF 


100800 phys mem 


100800 


100000 debug data 


EOOOOO 


40000 disp2 mem 


FAOOOO->FBFFFF 


20000 displjnem 


FCOOOO->FDFFFF 


10000 multibus 


FEOOOO->FEFFFF 


EOOO Color 


FF6000 


E400 Color 


FF6400 


E800 Color 


FF6800 


BOOO PEB Ctl 


FF7000 


B400 FPU Cmd 


FF7400 


GOOD FPU CS 


FF7800 


C400 Cache W 


FF7C00 


C800 Cache W 1 


FF8000 


FCOO Memory Ctl 


FF9000 


F400 disp 2 


FF9400 


FOOO disp 1 


FF9800 


BCOO ring 2 


FF9C00 


B800 ring 1 


FFAOOO 


8C00 floppy 


FFA800 


8800 timers 


FFACOO 


8400 sios 


FFBOOO 


8000 ramu 


FFB400 


4000 pft 


FFB800->FFF7FF 


iomap 


FFF800->FFF9FF 



CPU and MEMORY 
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PW BE S s im WDgs 



ADDRESSING iVIODES* 



CACHE 



Effective 
Address 
Modes 


iVlode 


Register 


Addressing Categories 


Assembler 
Syntax 


Data 


Memory 


Control 


Alterable 


Dn 
An 

An@ 


000 
001 
010 


register number 
register number 
register number 


X 
X 


X 


X 


X 
X 
X 


Dn 
An 
(An) 


An@+ 
An@- 
An(5)(d) 


Oil 
100 
101 


register number 
register number 


X 
X 
X 


X 
X 


X 


X 
X 
X 


(An)+ 
-(An) 
d(An) 


An@(d, ix) 
xxx.W 
XXX. L 


110 
111 
111 


register number 
000 
001 


X 
X 
X 


X 
X 
X 


X 
X 
X 


X 
X 
X 


d(An, Ri) 


PC@(d) 
PC@(d, ix) 


111 
111 
111 


010 
Oil 
100 


X 
X 
X 


X 
X 
X 


X 
X 




PC relative 
PCrel. +Ri 



[C400IFF7C00] [C800 |FF8000] 



To turn cache off, write a 5 to the FEB control register. 
See Chapter 6, PEB. 
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CPU and MEMORY 



(type "clock_t" in base. ins. pas) 

|< ,high >|<- -.lo >| 

47 33 32 16 15 

H H H + 

I I I I 

H H H + 



|<- .highie- ->|< .low32 >| 

Low^order bit represents 4 microseconds. 

Hardware clock is only 16 bits. Upper 32 bits are 
maintained by clock interrupt routine. There are 3 
hardware clocks (not counting calendar clock) : 



Clock 1 
Clock 2 
Clock 3 



4 microseconds (real-time clock) 
8 microseconds (process timer) 
128 microseconds (real-time intervals) 



CPU and MEMORY 2-4 apollo confidential iimterimal use only. 



qONDITION POPES * 





X 


IM 


Z 


V 


c 




ABCD 




U 


? 


u 


? 


C = Decimal Carry 
Z = Z • Rm • . .. • RO 


ADD, ADDI, 
ADDQ 








? 


? 


V = Sm • Dm • Rm + Sm • Dm • Rm 
C = Sm ■ Dm + Rm • Dm + Sm • Rm 


ADDX 












V = Sm - Dm - Rm + Sm • Dm • Rm 
C = Sm • Dm + Rm • Dm + Sm • Rm 
Z = Z • Rm •. .. • RO 


AND, ANDI, 
EOR, EORl, 
MOVEQ, MOVE, 
OR, ORI, 
CLR, EXT, 
NOT, TAS, TST 
















CHK 


_ 




u 


u 


u 




SUB, SUBI 
SUBQ 








? 


? 


V = Srn • Dm • Rm + Sm ■ Dm • Rm 
C = Sm • Dm + Rm • Dm + Sm • Rm 


SUBX 








' 


' 


V = Sm • Dm • Rm + Sill • Dm • Rm 
C = Sm • Dm + Rm • Dm + Sm • Rm 
Z = Z • Rm •. . . • RO 


CMP, CMPI, 
CMPM 


- 






? 


? 


V = S^-Dm-R^+Srn-Dw-Rm 
• C = Sm ■ Dm + Rm ■ Dm + Sm • Rm 


DIVS, DIVU 


- 






? 





V = Division Overflow 


MULS, MULU 


- 














SBCD, NBCD 








u 


? 


C = Decimal Borrow 
Z = Z • Rm • , . . • RO 


NEG 
NEGX 








? 


' 


V = Dm • Rm, C = Dm + Rm 

V = Dm • Rm, C = Dm + Rm 
Z = Z • Rm • .. . • RO 


BTST, BCHG, 
BSET, BCLR 


- 


- 




- 


- 


z = d;^ 


ASL 








' 


' 


V = Dm • (Dn,_i + . . . + D^^,) 
+ Dm-{D„_1+... +Dm_,) 
C = Dm-r+1 


ASL (r = 0) 


- 














LSL, ROXL 











? 


C = D^_,+1 


LSR(r = 0) 


- 














ROXL (r=0) 


- 









? 


C = X 


ROL 


- 









? 


C = D^_,+1 


ROL(r = 0) 


- 














ASR, LSR, ROXR 











? 


C = Dr_i 


ASR, LSR (r = 0) 


- 














ROXR (r = 0) 


- 









? 


C = X 


ROR 


- 









? 


C = D,_i 


ROR (r = 0) 


- 















- Not affected 

? Other - see Specia 
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CPU and MEMORY 



qONPITIQNAL TES T S * 



Mnemonic 


Condition 


Encoding 


Test 


T 


true 


0000 


1 


F 


false 


0001 





HI 


high 


0010 


c-z 


LS 


low or same 


0011 


c + z 


CC 


carry clear 


0100 


c 


CS 


carry set 


0101 


c 


NE 


not equal 


0110 


z 


EQ 


equal 


0111 


z 


VC 


overflow clear 


1000 


V 


VS 


overflow set 


1001 


V 


PL 


plus 


1010 


N 


Ml 


minus 


1011 


N 


GE 


greater or equal 


1100 


N • V+N • V 


LT 


less than 


1101 


N • V + N • V 


GT 


greater than 


1110 


N-V-Z+N-V-Z 


LE 


less or equal 


1111 


Z + l\l • V+ N • V 



CPU and MEMORY 
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qQ NFIGUPATIQN 



DN300 



I I I 

I CPU |==| MMU 

I I I 



i Main 
I Mem 



boot I 
prom 



I sio I 



I I 



I I 



I real | 
I tine I 
I elk I 



I I I 

I I +-keit)oard 

I H sio 1 

H sio 2 



I MMU I 
I ctl I 
I I 




floppy 
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CPU and MEMORY 



DN4XX and DN600 



I MEMORY 



MEMORY I- 
MANAGEMEOT | 
UNIT (MMU) 1 



CPU i 



H 1 BLOCK I- 

H 1 MULTIPLEXOR |- 



NODE PERI- 
PHERAL ADAPTER 



=1 FLOPPY 1 
(Shugart) 



I RING I 



-+ DISPLAY |=|TUBE| 
-+ MEMORY I H 1- 



= 1 BLT 



I DISK I 

i 1- 

( Priam) 



01 1 2 3 

H + Spinwriter 

|KBD| Tablet 

H + HASP, 3270 



— I LINE PRINTER | 
~ I OONTRDLLER | 



I I LINE PRINTER J 



(Printronix) 
(Tapenaster) 



-I MAG TAPE I 
-I CONTROLLER 1 



I I MAG TAPE 



(Cipher-F880) 



■ TWO FREE 
- SLOTS 



VERSATEC 
ETHERNET 



-I SMD I 
-i CONTROLLER i 



I AMPEX I 
I 300 MB SMD I 



CPU and MEMORY 
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EXCEFTIQN g RPPR gJACK Fmm 

DIG 00 

B WNyp^ SS EITO R gTACK F RA ME FO Pf ^T 
15 



+00 I STATUS REGISTER 

+02 1 PROGRAM 

i CDUNPER 



+06 I FRAME PORMAT/VOR ! 

H + 

+08 i SPEC. STATUS WORD | 

^ _ + 

+0A I FAULT I 

I ADDRESS I 

+0E I internal register I 

+10 I DATA OUTPUT BUFFER | 

H + 

+12 I internal register 1 

H + 

+14 I DATA INPUT BUFFER | 

H + 

+16 I internal register I 

H + 

+18 I INSTRUCTION REGISTER | 

+1A I I 

/ internal / 
/ registers / 
I I 

+3A H + 



FRA ME FQ RM ATAECIPR OFFSET WW 
15 12 9 



+- 



I mr 10 10 1 VEC offset | 
H +-+— ) + 



0000 - 4-word format: SR, PC, VOR 
1000 - 29-^ord 68010 format. 
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SPECIAL STATUS WORD 
15 14 13 12 11 10 9 



|RR| 0|IF|DF|RM1HB|BY|RW| 0| 01 0| Oi PCN 



I 





001 


- User data 




010 
101 
110 


- User program 

- Supervisor data 

- Supervisor 


Write 
Read 


111 


program 
- Interrupt 

acknowledge 



1 => Byte transfer 
1 => High byte (valid iff BY on) 
1 => Read-modify-write cycle 



- Data store from DOB 

1 - Data fetch to DIB 



1 => Instruction fetch 

- Processor will rerun bus cycle on RTE 

1 - Software has completed the bus cycle prior to RTE 



CPU and MEMORY 
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DN 4 XX an d m^QO 

(type "fault_$bus_info_t" in fault. ins. pas) 
15 



SP— > +00 
+02 



-RNFFF 



ACCESS 
ADDRESS 



+06 I INSTRUCTION REG. 



+08 I STATUS REG. 



+0A I PROGRAM 
+ 
I COUNTER 



+10 



} 

} I 

} .access_address 

} fault_$bus_info_t 

} I 

} Bus/addr 

} . inst_reg I 



I I 

Group 1 & 2 I 

Exceptions I 

I I 

__V V_ 



R - Read operation (.write op) 

N - Not instruction reference (.not_inst) 

FFF - Instruction function code (.function_code) : 

001 User data 

010 User program 

101 Supervisor data 

110 Supervisor program 

111 Interrupt acknowledge 



EXCEPTION TYPES 
GROUP 



Reset 
Bus Error 
Address Error 



Current instruction is aborted. 



Trace 
Interrupt 
Illegal Ins. 
Privilege Ins. 

TE^AP, TRAPV 

CHK 

Zero Divide 



Exception occurs before 
next instruction. 



Processed by normal instruction 
execution. 



Group exceptions are highest priority. 
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CPU and MEMORY 



EXCEPTION VECTORS 



Exception vector at [ 100400 | ] . 

TRAP PAGE (+ => DN300 only; - => unused on D^BOO) 

V eptoi: Addrepg A gpig n ine nt 

00 000 Reset: Initial SSP 

004 Reset: Initial PC 

02 008 Bus Error 

03 OOC Address Error 

04 010 Illegal Instruction 

05 014 Zero Divide 

06 018 CHK Instruction 

07 OIC TRAPV Instruction 

08 020 Privilege Violation 

09 024 Trace 

OA 028 Unimplemented instruction 

OB 02C Unimplanented instruction 

OC-OD 030 (Unassigned, reserved) 

+ OE 038 Invalid Stack Format 

OF-17 03C (Unassigned, reserved) 

18 060 Spurious Interrupt 

+ 19-lF 064 Level 1-7 Auto-Vector int level 

+ 19 064 SIO (rev and xmit) 1 

+ lA 068 Keyboard input 2 

+ IB 06C Ring 3 

+ IC 070 Display 4 

+ ID 074 Disk/floppy 5 

+ IE 078 Timers 1,2,3 6 

+ IF 07C Parity error 7 

20-2F 080 TRAP Instruction Vectors 

30-3F OCO (Unassigned, reserved) 

40-8F 100 User Int Vectors - unused 

- 90-9F 240 Ring/disk board 

AO-AF 280 User Int Vectors - unused 

BO 2C0 INTO/ - 

Bl 2C4 lOTl/ - 

B2 2C8 INr2/ - 

B3 2CC IMr3/ - Tape Controller 

B4 2D0 IMr4/ - Storage Module 

B5 2D4 INTS/ - 

B6 2D8 IOT6/ - Line Printer 

- B7 2DC IMr7/ - Parallel Input 
B8-C3 2E0 User Int Vectors — unused 
C4-CD 310 Unused 

- CE-CF 338 Color 

- DO-EF 340 SIO lines (even vectors only 

odd vectors unused) 

FO 3C0 P - ECCC (Automatic vectors) 

Fl 3C4 - 

F2 3C8 N - Display #2 

F3 3CC M - Floppy 

F4 3D0 L - Display #1 (BLT) 
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F5 


3D4 


K - 


F6 


3D8 


J - 


F7 


3DC 


I - 


F8-FA 


3E0 


Unused 


FB 


3EC 


Tiirers 1,2,3 


FC-FD 


3F0 


Unused 


FE 


3F8 


CPU B-to-A 


FF 


3FC 


ECCU 



FL OATING PQIICT FO R MAT 



gj, ng X e Pr ecisj.Qn Floating Point FQCtnat 

Implied noriialization bit 
V 
31 22 



! SEEEEEEEEMMMMM^M^lyIMMMM^M^ | 



S - Sign; S = 1 => Negative 
E..E - Exponent plus 127 
iyi..M - Mantissa 



Doulple Pi:ecisiQn Floating Point FQcmat 



Implied normalization bit 
V 
19 



I SEEEEEEEEEEEMMMMMMMMMMMiyiMMMMM^^ | 

H i- 

I PIMMMMMMIOTIMMMMMMMMMMMMMMMM^^ 



S - Sign; S = 1 => Negative 
E..E - Exponent plus 1023 
M..M - Mantissa 



APOLLO CONFIDENTIAL INTERNAL USE ONLY. 2-13 CPU and MEMORY 



-PPPPPPPPPPPPI 



P..P - Physical page nimber (PPN) 
(type "ppn_t" in base.spo.bbas) 

10 MAP at [ — I FFF800 ] . 

10 map supplies physical addresses for non-CPU 
memory references (ring/disk, PNA, display, floppy). 

See also lOMAP in Perij^eral I/O Section. 



m^ RY CQNITO I/ STATU S R E GI STE RS (MC S R) TO R PN3QQ 



MeiTPry Co ntro l Regis t er 

Address: [ 8004 | 0FFB404 ] 



+- 



-+- 



-+- 



5 I 4 i 3 I 2 i 1 I I 

_+ ^ ^ H 1 1- 



\. 



J 



LEDS 

TOP BOT 

(RIGHT) (LEFT) 



I 



1 => Enable parity err traps 
I 
1 => Force right byte parity 

1 => Force left byte parity 

1 => Parity during DMA cycle 

Menypry Stat us Regis te r 

Address: [ 8006 I 0FFB406 ] 
15 4 



I FAILING PPN I X I 



I I 



I I 

I 1 => Parity error traps enabled 

I 

1 => Right byte parity error 

1 => Left byte parity error 

Writing MSR clears parity error condition. 



CPU and MEMDRY 



APOLLO CONFIDENTIAL. INTERNAL USE ONLY. 



MEMORY GOMTROL/STATUS REGISTERS (MCSR) FOR DN4XX AND DN600 



Board 1 
Board 2 
Board 3 
Board 4 



[ PC02 I FF9002 ] 

[ FD02 I FF9102 ] 

[ FE02 I FF9202 ] 

[ FF02 I FF9302 ] 



MCSR Control (Write-Only) 
15 



4- 



D - Lock check bits on write (diag mode only) 
C - Enable ECCC interrupts (through 3C0) 
U - Enable ECCU interrupts (through 3FC) 

Any write to this register acknowledges the interrupt. 

MCSR Status Register (Read-Only) 

31 24 23 



I SSSSSSNU I PPPPPPPPPPPPPPPPPPPPPPPW I 

H H + 

S..S - Syndrome (valid only for ECCC error) 



DO data bit 


00 


70 


data 


bit 


08 


2C data bit 15 


C8 


01 


68 


" 




09 


F8 check bit 


C4 


02 


58 


" 




10 


F4 " 1 


BO 


03 


54 


" 




11 


EC " 2 


A8 


04 


4C 


" 




12 


DC " 3 


A4 


05 


38 


" 




13 


BC " 4 


94 


06 


34 


" 




14 


7C " 5 


8C 


07 













N - No error (0 => error detected, status valid) 

U - Uncorrectable error (ECCU) 

P..P - High order 23 bits of j±iysical address 

(low order bit is always 0) 
W - Error during read-modify-write operation 
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MEMORY BOARD JUMPERS FOR DN4XX AND DN600 

Board # JSl JM Afcg Address Mapped Address 



out 



in 


fc02 


ff9002 


in 


fd02 


ff9102 


out 


fe02 


ff9202 


out 


ff02 


ff9302 



Each board type has an address range that it can span specified by 
three jumpers, JP13, JP14, and JP15. 

Memory Board Address Ranges 

256KB Board # JP13 

1 in 

2 out 

3 in 

4 out 
3* in 
4* out 

* Use these values if there 
board in the system 



JP14. 


JPIS 




out 


out 


100000-13ffff 


out 


out 


140000-17ffff 


out 


in 


180000-lbffff 


out 


in 


IcOOOO-lfffff 


in 


in 


80000-bffff 


in 


in 


cOOOO-fffff 



are 2 512kb boards or 1 Imb 



512KB Board # 

1 
2 
3 
4 

1MB Board # 

1 
2 
3 
4 



JP13 



JP13 



JP14 



out 
out 



JP14 



JP15 
out 



JP15 



in out out 

out in out 

out out out 

*** not allowed *** 



Address Range 

100000-17ffff 
180000-lfffff 
200000-27ffff 
080000-Offfff 

Address Range 

100000-lfffff 
200000-2fffff 
300000-3fffff 



The memory test program checks that the tables above are 
satisfied. 
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256K 512K 1M 256K adr 



1.0 M 








1 


2.0 M* 








2 - 


3.0 M* 








3 - 


0.5 M 





1 





1.5 M 





1 


1 


2.5 M* 





1 


2 


3.5 M* 





1 


3 


1.0 M 





2 


- 


2.0 M* 





2 


1 


3.0 M* 





2 


2 


1.5 M 





3 


- 


2.5 M* 





3 


1 


1.25 M 







1 1: 


2.25 M 







2 1: 


0.75 M 




1 


1: 


1.75 IVI 




1 


1 1: 


2.75 M 




1 


2 1: 


1.25 M 




2 


1: 


2.25 M 




2 


1 1: 


1.75 M 




3 


1: 


0.5 M 


2 





1: 


1.5 M 


2 





1 1: 


1.0 M 


2 


1 


1: 


2.0 M 


2 


1 


1 1: 


1.5 M 


2 


2 


1: 


0.751V! 


3 





1: 


1.25 M 


3 


1 


1: 


1.0 M 


4 





1: 




that the 


configuration requires a 







1:100 






1:100 2:200 






1:100 2:200 3:300 






2:200 






2:200 3:300 






1:100 2:200 3:300 


2:180 




- 


2:180 




3:300 


4:080 




2:200 3:300 


2:180 3 


180 


- 


2:180 4:080 


3:300 






2:200 






2:200 3:300 






3:300 






2:200 3:300 



100 




2:180 3:200 4:080 


- 


100 2:140 




- 


- 


100 2:140 




- 


3:300 


100 2:140 




3:200 


- 


100 2:140 




4:080 


3:300 


100 2:140 




3:200 4:080 


- 


100 2:140 


3:180 


- 


- 


100 2:140 


3:180 


4:080 


- 


100 2:140 


3:180 


- 


- 



DOMAIN DN400 or DN420 cpu. 



If you reconfigure memory boards, you must change the jumpers. Do n^ 
those attached at jumper points 3,4, 13, 14, and 15. 



ly jumpers other than 
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JP13 
JP14 
JP15 



COORDINATE LOCATION (APPROXIMATE) 

L-23 
L-23 

M-25 
M-25 
N-25 



MEMORY MANAGEMENT UNIT (MMU) 



STATISTICS 




DN4XX and DN600 



PID/PRIV/POWER 


[ 8000 


FFB400 ] 


CPU A Control 


[ 8002 


FFB402 ] 


MMU Status, High 


[ 8004 


FFB404 ] 


MMU Status, LOW 


[ 8006 


FFB406 ] 


Clear MMU Status 


[ 8008 


FFB408 ] 


Bus Status 


[ 800A 


FFB40A ] 


Enable CPU B 


[ 800E 


FFB40E ] 



[ 8000 I FFB400 ] 
[ 8002 I FFB402 ] 
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DN300 PID/PRIV Register 

Address: [8000 | 0FFB400 ] 
15 8 



I I ASID I- 



P I M 



1 - Enable MMU 
Enable PTT access 



DN300 MMU Status Register 

Address: [ 8002 | 0FFB402 ] 



Domain 
Domain 1 



H +- 

I 7 I 



-+- 



-+- 



4 I 3 I 2 I 1 I I 



+- 



-+- 



-+- 



-+ 



I 1 => MMU enabled 

I 

1 => PTT access enabled 

1 => 4K PFT 

1 => Interrupt pending 

1 => Normal mode 

1 => Bus timeout 

1 => Page fault 

1 => Access violation 

DN4 x y a n d dn^OO pid/priv Registe r 



Address: [ 8000 
15 8 7 



FFB400] 




IE I ASID 



E - Enable power-off switch 
DD - Domain: 

GO User domain (least protected) 

01 User domain 1 

10 Supervisor domain 

11 Supervisor domain 1 (roost protected) 
P - PTT access enable 

M - Enable MMU (virtual memory operations) 



CPU and MEMORY 



APOLLO CX3NFID EN TIAL IIVTERNAL USE ONLY. 



DN4XX and DN600 CPU A Control Register 

Address: [ 8002 | FFB402 ] 
15 8 7 



lA - Interrupt and/or abort: 

00 CPU A will resume operation 

01 CPU A will abort the attempted bus cycle 
10 CPU A will receive level 6 interrupt 

DN4XX and DN600 MMU Status Register 

Address: [8004 | FFB404 ] 
31 24 23 

H ^ . 1. 

iMAFFFRVBi FAULTING VIRTUAL ADDRESS | 

M - PFT miss (AS ID and/or VPN not found) 
A - Access fault (protection violation) 
FFF - CPU function code: 

001 User data reference 

010 User procedure reference 

101 Supervisor data reference 

110 Supervisor procedure reference 

111 Interrupt acknowledge 
R - Read operation 

V - MMU status register is valid 

B - Miss occurred while CPU B running 

DN4XX and DN600 Clear MMU Status 

Address: [ 8008 | FFB408 ] 

When written, clears MMU status conditions. 

DN4xx and DN600 Bus Status Register 

Address: [ 800A | FFB40A ] 
16 8 7 



I I IMPGTBWS I 

H + + 



I = => unacknowledged interrupt pending 

M - MMU enabled 

P - PTT enabled 

G - Big PFT (2K entries if not set, 4K if set) 

T - Bus time-out (cleared by a read) 

B - CPU B active 

W - State of power-off switch (1 => ON position) 

S - State of service switch (1 => Normal position) 
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DN4XX and DN600 Enable CPU B Register 

Address: [ 800E I FFB40E ] 

Any write will explicitly enable CPU B. Return to CPU A, 
only by Reset. 

PAGE FRAME TABLE EIJPRY fPFTE) 

(type "pfte" in irmap.bbvt.bbas) 
31 24 23 16 15 8 7 



H H + 1- H 

iAAAAAAAS lEWRXPPPP | EMUGLLLL | LLLLLLLL | 

^ 1- + + 1- 

A. .A - Address space ID (0-127) (.elsid) 

S - Supervisor dDitain (.elccess) 

D - Domain (0 or 1) 

W - Write access 

R - Read access 

X - Execute access 

P..P - Excess virtual page number (.xsvpn) 

E - End of chain (.eoc) 

M - Page modified (.bbmod) 

U - Page referenced (.used) 

G - Page is global (.global) 

L..L - PFT hash thread (.link) 

PFT at [ 4000 I FFB800 ] through [ 8000 I FFF800 ] . 

One entry per physical page of memory. 



PAGE TOANSLATIC^ TABLE ENTRY (PTTE) 

(type "ppn_t" in base.spo.bbas) 

15 

H h 

I PPPPPPPPPPPP I 

H h 

P..P - Riysical page nunber (PPN) 

Page Translation Table at [ n/a I 700000 ] . 

One PPTE every 1024 bytes in table. 
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31 16 15 8 7 



































DO 
Dl 
D2 
D3 
D4 
D5 
D6 
D7 

AO 

Al 

A2 

A3 

A4 

A5 (DB) 

A6 (SB) 



DB — > Start of Data Section 

SB — > Top of current Stack Frame 



User Stack Pointer 



i Supervisor Stack Pointer 

H + 

* Choice made on basis of S bit in SR 



A7 (SP) * 



I PC 



System User 

i T-S— III I XNZOC I SR 

H H + 

T-Trace Mode Ill-Interrupt Level X-Extend 0-Overflow 
S-Supervisor Mode 000-enabled N-Negative C-Carry 
111 - disabled Z-Zero 
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CHAPTER 3 
DISPLAY HARDWARE 



DN4XX 










15 GREEN 


CRT: 








WOl-DCWN 


W02-DOWN 


W03-UP 


W04-UP 


W05-UP 


W06-UP 


W07^rOP-LEFT* W08-UP 


W09-UP 


WIO-UP 


Wll-UP 


W12-UP 


W13-LEFT 


W14-RIGHT 


W15-LEFT 


W16-TOP-LEFT W17-UP 


W18-UP 


W19-UP 


W20-UP 


W21-UP 


W22-UP 


W23-UP 


W24-UP 


W31-UP 


15 BLACK 


& WHITE CRT: 








WOl-DOWN 


W02-DCWN 


W03-UP 


W04-UP 


vros-up 


W06-DOWN 


W07-* 


W08-UP 


W09-UP 


10-DOWN 


Wll-DCWN 


W12-DCWN 


W13-LEFT 


W14-LEFT 


W15-LEFT 


W16-* 


W17-D0WN 


W18-UP 


W19-D0WN 


W20-DOWN 


W21-UP 


W22-CUT 


W23-DCWN 


W24-DCWN 


W31-UP 


19 BLACK 


& WHITE CRT 








WOl-DCWN 


W02-UP 


W03-UP 


W04-DCWN 


W05-DCWN 


W06-DCWN 


W07- * 


W08-DCWN 


W09-DCIWN 


WIO-DCWN 


Wll-DOWN 


W12-DCWN 


W13-RIGHT 


Wl4-LEPr 


W15-RIGHT 


W16-* 


W17-D0WN 


W18-UP 


W19-D0WN 


W20-DOWN 


W21-D0WN 


W22-DCWN 


W23-DCWN 


W24-DCWN 


W31-D0WN 



* W07 AND W16 SHOULD BE SET BY SPECIFICATIONS ON CLOTH TAG, 
MOUNTED ON PCB. 



DISPLAY BOARD 2 



DISPLAY BOARD 1 



W25-D0WN 
W27-DCWN 
W29-DCWN 



W26-DCWN 
W28-DCIWN 
W30-DCWN 



W25-RIGHT 
W27-RIGHT 
W29-UP 



W26-UP 
W28-UP 
W30-UP 
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ARRAY BOARD JUMPER PLACEMENT: 

BOARD ORIENTATION: EJECTORS FACING UPWARDS 

JUMP W01 W02 W03 W04 W05 

LOCT ~A08 ~A09 -All ~A12 -All 

ARR 1 LEFT LEFT UP UP UP 
ARR 2 RIGHT RIGHT 



W09 

C02-18 

OUT 



DOWN DOWN DOWN DOWN DOWN UP 



II I I III I II I ll| 

W01 W02 



Jl I II I III II II 



7ur 



W03 W04 
W05 W06 



W07 W09 
W08 



CONTROL BOARD JUMPER PLACEMENT: 

BOARD ORIENTATION: EJECTORS FACING UPWARDS 
W03 W04 

'H22 ~H25 
DOWN DOWN 

"ur 



JUMPER W01 

LOCATION ~B20 

ORIENTATION UP 



W02 
~H19 
DOWN 



RIGHT UP 




ORDER OF BOARDS: FACING FRONT OF NODE 



DI SPLAY CO^nroi^ J^g) S TATES PEGISTg R (DCS R ) 
DN300 

WRITE READ 

+00 DISPLAY CONTROL DISPLAY STATUS 

+02 DEB 

+04 WSSY 

+06 WSSX 

+08 DCY 

+0A DCX 

+0C WSDY 

+0E WSDX 

DI SPL^^Y QO m Wh REGIjg TEg^ [ 9400 I 0FF9800 ] 

8000 - GO (Start bit operation) 15 

0020 - Interrupt at end of frame 5 

0010 - Interrupt at end of bit operation 4 

0008 - Incronent Y coordinate 3 

0004 - Increment X coordinate 2 

0002 - Fill mode bit operation 1 

0001 - Enable display (blank if reset) 

DISPLAY STATUS REGISTER [ 9400 | 0FF98O0 ] 

8000 - Bit operation in progress 15 

0080 - End of frame interrupt 7 

0002 - Reserved 1 
0001 - Reserved 
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DN4xx 

[ POOO I PF9800 ] 



15 


14 


13 12 


11 10 9 


8 


1 GO 1 


X 


I X 1 X 


1 X ! X 1 X I 


NIL 1 


7 


6 


5 4 


3 2 1 





IFROMMMI 


TO MM 


i I BOFI IDONElNDNCONFl DECRl FILLi 


ON 1 



R/W BIT NAME 

R/W 15 GO - When set, this bit initiates a BLT 
operation. When cleared, this bit 
will abort any BLT in progress. When 
read, this bit will be set so long at 
a BLT operation is in progress. 

W 8 NIL - When set, enables non-interlaced 
mode. In this mode, only the odd 
lines are displayed at 60 frames per 
second. 

W 7 FROM MM - When set, enables BLT's from main 
memory as specified by the source 
box. This bit must be set in advance 
of the write operation that initiates 
a BLT. It should be cleared by a 
separate write operation after the 
BLT completes. 

W 6 TO MM - When set, enables BLT's to main 
memory as specified by the 
destination box 

W 5 lEOF - When set, enables a 60 hz interrupt 
request after the last line in the 
current field. This request must be 
acknowledged by reading from address 
DCSR +2. 

W 4 IDONE - When set, enables interrupt request 
when BLT is done. 

W 3 NON OONF- When set, enables non-conforming BLT 
mode. 

W 2 DECK - Must be set when doing a BLT that 
decrements the x coordinate. 

W 1 FILL - When set, BLT fill mode is enabled. 
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■ When set, display is on; when 
display is blanked. 



DN6Q0 



CQW^h fiEGIg TE R [ EOOO | FF6000 ] (Syston) 

[ E400 I FF6400 ] (User) 

BIT mm FUNCTION 

15 Reserved Set to zero 

14 Reserved Set to zero 

13 Unused 



12 


Unused 


11 


Unused 


10 


Unused 


9-4 


WCSADH<5:0>+ 



During reads and writes to the 
control store through the control 
store window these bits are used 
as the upper part of the control 
store address. 

This bit is used to enable or 
disable the video to the monitor. 

When this bit is asserted the micro 
machine is reset, the control store 
may be accessed through its window 
and no micro code is executed. The 
display will continue to be refreshed, 
no changes will be made to the 
display memory, and no software 
visible state will change. 

When this bit is set the micro 
machine clocks will run. 

When the CLKHUNf bit is not set the 
micro-machine clocks can be made to 
go through one clock cycle by 
toggling this bit low to high. 



Display Hardware 
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status Pegister 



FUNCTION 

This bit is asserted by micro code to 
indicate that the micro machine is 
ready to handle reads or writes to 
its command pages 

When this bit is asserted the display 
is currently in the vertical blanking 
period. 



INSP_DONE- This bit is asserted by micro code to 
indicate that is done executing an 
instruction queue. 

12 CLKON+ This bit indicates that the micro 
machine clocks are running. 

11-0 NXTAD<11:0>- Tliese bits are the state of the next 
address bus at the end of the last 
micro cycle. This is needed in order 
to know the micro address when micro 
code is being clock stepped. 
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BLT REGISTE3^ 
DN300 



(Each has an address used for reading and a separate 
address used for writing.) 

DESTimrim OOIMF Y register [ 9414 I 0FF9814 ] 

15 9 



-CCCCCCC(XC| 



CCXZCCC = -1 - ABS (WDSY - WDEY) 

= two's coinpleinent of # lines in height 
of destination block 



DEgriNATION OOUOT X REGISTESt [ 9416 I 0FF9816 ] 
15 5 



~CCC(XC| 



(XCCCC = -1 - ABS(WDSX/16 - WDEX/16) 

= two's coinplonent of # 16-bit aligned 
words involved in x coordinate 



DE g Ti mTION ENP BIT REGXSTgR [ 941C I 0FF981C ] 
15 7 3 
I OOOOEEEEl 



EEEE = WDEX mod 16 

= bit number in word of last bit of X 
DN4xx 

Source and Destinat ion Control Register; 
31 16 

H H + 

I Y addr. control | X addr. control! 
H H + 
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Y address control: 
X address control: 



ingranent Degreinent 

0202 0606 
0020 0060 



(RCS) Read source control reg. $FF988C 

(WCS) Write source control reg. $FF9884 

(RCD) Read destination control reg. $FF9888 

(WCD) Write destination control reg. $FF9880 



gQurge,/t>est3.natiQn gtart/End Registers; 

31 26 25 16 9 



VI 



X-coord. (Low order four bits 
are write only) 



■ Used in BLT's to or from nain memory 



(RSS) Read source start reg. 
{VES) Write source start reg. 
(RES) Read source end reg. 
(WES) Write source end reg. 

(RSD) Read destination start reg. 

(WSD) Write destination start reg. 

(RED) Read destination end reg. 

(WED) Write destination end reg. 



OS V i r tua l A d dre s s 

$FF989C 
$FF98AC 
$FF9894 
$FF98B4 

$FF9898 
$FF98A8 
$FF9890 
$FF98B0 



When start or end registers are used to specify locations 
in main memory f the correspondence is as follows: 



lOVPN iBN 



BN I- 



9:7 

I 



6:1 

I 



-+- 



101 

-4-+ 



I/O virtual 
page number 



> < 10 > 

Byte in page 



Start or End 
Register 



I/O Virtual Address 
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DN600 

15 8 7 4 3 

H H 1 i- 

IXXXXXXXXI HALT STATUS I X IN SY SAI 

H 1 1 + 

IN = 1 Color display is executing an instruction queue 
starting at the address held in the instruction 
queue start location. 

SY = 1 Color display is in systen mode and will 
execute syston functions. 

SA Most significant address bit of all i/o addresses 
to be used by the color display for dna. 

HALT STATUS 

Normal completion 

1 Illegal opcode 

10 Uninplemented instruction 

11 BLT to main memory out of image memory region 

1111 Not halted 
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CHAPTER 4 
ERROR CODES AND MESSAGES 



AEGIS ERROR CODES 



I FSSSSSSS I AMMMMMMM | CCCCCCCCCCCCCCCC | 

H H H (. 



F = 1 => module couldn't handle error 

S..S - Subsystem identification 

A = 1 => asynchronous fault; only set during delivery 

of fault 
M,.M - Module identification 
C.C - Module-specific error code: 

= OK status 
negative = warning 
positive = error 

("status_$t" in base.spoas) 

00000000 status_$ok 

00000001 - OOOOOOOF Program return codes 

OS / BAT manager: 

(00010001) attempt to free already-freed block 

(00010002) disk is full 

(00010003) attanpt to free illegal disk address 

(00010004) BAT not mounted 

(00010005) disk needs salvaging 

OS / VTOC manager: 

(00020001) VTOC not mounted 

(00020002) VTOC is bad 

(00020003) no file irap 

(00020004) no UID 

(00020005) not found 

(00020006) UID not found 

(00020007) duplicate UID 

(00020008) uid mismatch 

OS / AST manager: 

(00030001) attonpted reference to out-of-bounds address 

(00030003) no replaceable aste's 

(00030004) segment is not deactivatable 

(00030005) write concurrency violation 

(00030006) incompatible request 

(00030007) reference count says unused 
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OS / MST manager: 

(00040001) object not found 

(00040002) invalid length 

(00040003) no space available 

(00040004) reference to illegal address 

(00040005) reference to out-of-bounds address 

(00040006) no asid is available 

(00040007) object is not napped 

(00040008) no rights 

(00040009) insufficient rights 
(0004000A) guard fault 

(0004000B) wrong type - can't map system objects 

(0004000C) ppn list overflow 

OS / PMAP manager: 

(00050001) not allocated 

(00050002) already allocated 

(00050003) mismatch 

(00050004) bad wire 

(00050005) bad unwire 

(00050006) bad assoc 

(00050007) pages wired 

(00050008) page null 

(00050009) bad disk address 
(0005000A) read concurrency violation 
(0005000B) changed pinods 

OS / MMAP manager: 

(00060004) bad avail 

(00060005) bad free 

(00060006) bad unavail 

OS / MMU manager: 

(00070001) mmu miss 

OS / disk manager: 

(00080001) disk not ready 

(00080002) disk controller busy 

(00080003) disk controller time-out 

(00080004) disk controller error 

(00080005) disk equipment check 

(00080006) floppy is not 2-sided 

(00080007) disk write protected 

(00080008) bad disk format 

(00080009) disk data check 
(0008000A) DMA overrun 
(0008000B) volume in use 
(0008000C) volume table full 

(0008000D) volume not properly mounted or assigned 

(0008000E) operation requires a j^ysical volume 

(0008000F) invalid volume index 

(00080010) logical volume not found 

(00080011) disk block header error 

(00080012) invalid disk address 

(00080013) disk buffer is not page aligned 
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(00080014) invalid logical volume index or list 

(00080015) disk seek error 

(00080016) drive timed out iDefore operation completed 

(00080017) bus error occurred during disk DMA transfer 

(00080018) invalid unit number 

(00080019) unknown status returned by hardware 
(0008001A) invalid ^lysical volume label 
(0008001B) floppy door has been opened or storage 

module has been stopped 

(OOOeOOiC) read after write failed 

(0008001D) drta not at end of range 

(0008001E) disk already mounted 

(0008001F) software detected checksum error 

(00080020) checksum error in read after write 

(00080021) too many wired pages — storage module 

manager 

(00080022) storage module manager logic error 

(00080023) unknown error status from storage module 

controller 

(00080024) unrecognized drive id 

OS / eventcount manager: 

(00090001) bad wait list on eventcount 

OS / level 1 process manager: 

(OOOAOOOl) illegal process id 

(OOOA0002) illegal lock 

(000A0003) process not suspended 

(000A0004) process already suspended 

(000A0005) process not bound 

(000A0006) process already bound 

(000A0007) bad atomic operation 

(000A0008) no pcb is available 

(000A0009) no stack space is available 

(OOOAOOOA) process not suspendable 



OS / terminal manager: 

(OOOBOOOl) buffer too small 

(000B0002) end of file entered from keyboard 

(OOOB0003) invalid output length 

(000B0004) invalid option passed to term_$control 

(000B0005) input buffer overrun - characters lost 

(OOOB0006) quit vdiile waiting for input 

(000B0007) invalid line nuirber supplied 

(000B0008) manual stop: type G<ret>G *+2<ret> to 

continue 

(000B0009) character framing error 

(OOOBOOOA) character parity error 

(OOOBOOOB) data carrier detect (dcd) changed 

(OOOBOOOC) clear to send (cts) changed 

(OOOBOOOD) requested line or operation not impleonented 



OS / DBUF manager: 
(OOOCOOOl) bad ptr 
(000C0002) bad free 
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OS / time manager: 

(OOODOOOl) no timer queue entry 

(000D0002) entry to be cancelled not found 

(000D0003) quit vAiile vaiting for event 

(000D0004) bad timer interrupt 

(000DO005) bad timer key 

(000D0006) alarm fault 

OS / naming server: 

(000E0002) directory is full 

(000E0003) name already exists 

(000E0004) invalid pathname 

(000E0005) invalid link 

(000E0006) not a link 

(000E0007) name not found 

(OOOEOOOA) invalid link operation 

(OOOEOOOB) invalid leaf 

(OOOEOOOC) node is unavailable 

(OOOEOOOD) bad directory 

(OOOEOOOE) branch is not a directory 

(OOOEOOOF) directory is not empty 

(OOOEOOIO) name is not a file 

(OOOEOOll) illegal directory operation 

(000E0012) bad type 

(000E0013) no rights 

(000E0014) insufficient rights 

(000E0015) unable to delete system bootstrap (sysboot) 

OS / file server: 

(OOOFOOOl) object not found 

(000F0002) object is remote 

(000F0003) bad reply received from remote node 

(000F0004) coimunications problon with reoaote node 

(000F0005) object is not locked by this process 

(000F0006) object is in use 

(000F0007) illegal lock request 

(000F0008) lock violation detected 

(000F0009) local lock table is full 

(OOOFOOOA) remote lock table is full 

(OOOFOOOB) operation cannot be done from here 

(OOOFOOOC) no more lock table entries 

(OOOFOOOD) volume uid is unavailable 

(OOOFOOOE) locking files is blocked for this volume 

(OOOFOOOF) locking is already blocked for this volume 

(OOOFOOIO) no rights 

(OOOFOOll) insufficient rights 

(000F0012) wrong type - can't operate on system objects 

(000F0013) objects are on different volumes 

OS / I/O manager: 

(00100001) dcte not found 

(00100002) controller not in system 

OS / network: 

(00110004) transmit failed 

(00110007) remote node failed to respond to request 
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(00110008 
(00110009 

(oohoooa: 
(oohooob: 
(oohoood: 
(ooiioooe; 
(oohooof; 
(ooiiooio: 

(00110011 

(00110012: 

(00110013 
(00110014 
(00110015 

OS / fault 

(00120001 

(00120002 

(00120003 

(00120004 

(00120005: 

(00120006 

(00120007 

(00120008 

(00120009 

(0012000a; 

(0012000b: 
(0012000C 
(0012000D: 
(0012000E 
(0012000F 
(00120010: 
(00120011 
(00120012: 
(00120013 
(00120014 
(00120015 
(00120016: 

(00120017: 

(00120018 
(00120019 
(0012001a: 
(0012001B 
(0012001C 
(0012001D; 
(0012001E 
(0012001F 
(00120020 



unable to route 

network hardware error 

msg header too big 

unexpected r^ly type 

unknown request type 

request denied by local node 

request denied by remote node 

bad checksum 

too many transmit retries 

socket not open 

receive bus error 

transmit bus error 

bad asknode version number 

handler: 
odd address error 
illegal instruction 
integer divide by zero 

CHK instruction trapped - value out of range? 
arithmetic overflow 
privileged instruction violation 
invalid SVC code 
invalid SVC procedure name 
undefined TE^AP instruction 
unimplanented instruction 
protection boundary violation 
bus time-out 

invalid user stack pointer 
correctable roanory error detected 
uncorrectable memory error detected 
process quit 
access violation 

CPU B enabled with MMU valid bit reset 
null process running on CPU B 
OS-internal quit (with display return) 
single step completed 
invalid user-generated fault (subsystem 

code = 0) 
fault in user-space interrupt handler for 

pbu device 
process stop 
process BLAST 
PEB cache parity error 
PEB Vies parity error 
unimplanented SVC 
invalid stack format 
memory parity error 
process interrupt 
supervisor fault vAiile resource lock(s) set 



OS / display driver: 

(00130001) invalid display unit number 

(00130002) specified font not loaded 

(00130003) internal font table full 

(00130004) invalid use of display driver procedure 

(00130005) font too large 
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error unloading internal (hdmt) table 

invalid direction from S!A 

unexpected BLT in use 

internal protocol violation 

too many pages to be wired 

unsupported font version # 

invalid buffer size 

error mapping display memory 

error borrowing display from screen manager 

unable to borrow - display in use 

display borrow request denied by screen 

manager 

error returning display to screen manager 
can't return - display not borrowed 
can't borrow both displays simultaneously 
display already borrowed by this process 
invalid position argument 
invalid window limits argument 
invalid length argument 
invalid direction argument 
invalid scroll displaconent argument 
invalid bit mode register 
invalid bit control register 
invalid bit-done interrupt 
invalid interrupt routine state 
invalid screen coordinates in bit request 
font associated with specified id not napped 
display memory is already napped 
display memory is not mapped 
quit viiile waiting 
invalid cursor nurrber 
hidden display memory is full 
quit v^iile waiting 
invalid eventcount key 

operation not implemented on color display 
non-conforming and main memory bits not 

implemented 



OS / volume manager: 
(0014FFFF) warning: disk is write protected 

entry directory problems on logical volume 

unable to dismount the boot volume 

logical volume is not mounted 

entry directory is not on specified logical 
volume 
(00140005) physical volume replaced since mount 



(00130006 
(00130007 
(001301)08; 
(00130009 
(0013000A] 

(0013000b; 
(0013000c; 

(0013000D 
(0013000E; 
(0013000F; 
(00130010 

(00130011 
(00130012 
(00130013 
(00130014 
(00130015; 
(00130016 
(00130017 
(00130018; 
(00130019 
(0013001A] 

(0013001b; 
(0013001c; 

(0013001D; 
(0013001E 
(0013001F 
(00130020 
(00130021 
(00130022; 
(00130023 
(00130024 
(00130025; 
(00130026 
(00130027 
(00130028 



(00140001) 
(00140002) 
(00140003) 
(00140004) 



OS / calendar manager: 

(00150001) invalid syntax for date or time 

specification 

(00150002) date or time specification invalid 

(00150003) an empty string was passed to a decode 

routine 

(00150004) timezone specified is unknown 

(00150005) invalid time-zone difference 
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OS / level 2 eventcount manager: 

(00180001) internal table exhausted 

(00180002) internal error 

(00180003) process quit vdiile waiting 

(00180004) bad eventcount 

OS / level 2 process nanager: 

(00190001) process not found 

(00190002) not a level two process 

(00190003) bad stack base 

(00190004) request is for current process 

(00190005) suspend request timed out 

(00190006) process not suspended 

(00190007) process already suspended 

(00190008) child process terminated 

(00190009) another fault is pending for this process 

OS / import/export nanager: 
(OOlAOOOl) entry directory is not cataloged in the 

namespace 
(001A0002) files are locked on this volume 
(001A0003) specified entry directory not on this volume 
(001A0004) volume is not mounted 

OS / startup/shutdown: 
(OOlBOOOl) node ID mismatch 

OS / vfmt: 

(OOlCOOOl) unterminated control string 

(001C0002) invalid control string 

(001C0003) too few arguments supplied for read/decode 

(001C0004) field width missing on "(" designator 

(001C0005) encountered end of string where more text 

expected 
(001C0006) encountered null token where numeric token 

expected 
(001C0007) non-numeric character found where numeric 

was expected 
(001C0008) sign encountered in unsigned field 
(001C0009) value out of range in text string 
(OOICOOOA) character in text string does not itatch 

control string 
(OOICOOOB) terminator in text string does not natch 

specified terminator 

OS / circular buffer nanager: 
(OOlDOOOl) invalid block size requested 
(001D0002) quit v^ile waiting 
(001D0003) buffer wrap-around error 

OS / fi)U nanager: 

(OOlEOOOl) ddf is larger than one page 
(001E0002) ddf has wrong version 
(001E0003) invalid unit number in ddf 
(001E0004) invalid csr page address in ddf 
(001E0005) csr page is in use 
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(001E0006) initialization routine not in library 

(001E0007) cleanup routine not in library 

{001E0008) interrupt library too large 

(001E0009) interrupt routine not in library 

(OOIEOOOA) pbu not present 

(OOIEOOOB) too many pbu manager pages wired 

(OOIEOOOC) invalid unit number 

(OOIEOOOD) unit in use 

(OOIEOOOE) unit not acquired 

(OOIEOOOF) unit already acquired 

(OOIEOOIO) bad parameter 

(OOlEOOll) no room in iomap 

(001E0012) requested iomap in use 

(001E0013) iomap already allocated 

(001E0014) iomap not allocated 

(001E0015) invalid iova 

(001E0016) buffer too large 

(001E0017) buffer page not wired 

(001E0018) buffer not napped 

(001E0019) page already wired 

(OOIEOOIA) page wired too many times 

(OOIEOOIB) page not wired 

(OOIEOOIC) reference to csr page caused bus timeout 

(OOIEOOID) trap 6 executed outside of interrupt routine 

(OOIEOOIE) invalid trap 6 code 

(OOIEOOIF) invalid usp at trap 6 

(001E0020) invalid argument at trap 6 

(001E0021) unexpected interrupt from pbu device 

(001E0022) ddf has wrong file type 

{001E0023) too many wired pages 

(001E0024) csr not in device's csr page 

(001E0025) controller already mapped 

(001E0026) bad controller memory length 

(001E0027) bad buffer address 

(001E0028) interrupt library not found 

(001E0029) device library not found 

OS / line printer module: 

(OOlFOOOl) pna board not installed in systen 

(001F0002) invalid string length 

(001F0003) invalid string termination 

(001F0004) line printer not acquired 

(001F0005) line printer already acquired 

(001F0006) internal error 

(001F0007) ppn list overflow - internal error 

(001F0008) line printer not assigned 

OS / OS info supplier: 

(00200001) array too small for complete table 

OS / badspot manager: 

(00210001) bad checksum in jAiysical badspot block 

(00210002) bad count in physical badspot block 

(00210003) missing minus-one in physical badspot block 

(00210004) badspot list too small 

(00210005) no physical badspot blocks read or written 
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(00210006) physical badspot list partially read or 

written 

(00210007) duplicate entry in badspot list 

(00210008) no j^ysical badspot inforitation on disk 

(00210009) bad daddr for Iv label badspot extension 

block 

OS / magtape nanager: 



(0022FFFE; 
(0022FFFF 
(00220001 
(00220002 
(00220003: 
(00220004 
(00220005 
(00220006: 
(00220007: 
(00220008 
(00220009 
(0022000a; 
(0022000b; 
(0022000c; 
(0022000D: 
(0022000E; 
(0022000F 
(00220010 
(00220011 
(00220012 
(00220013 
(00220014 
(00220015 
(00220016: 
(00220017: 
(00220018; 
(00220019 
(0022001A] 
(0022001b; 
(0022001c; 
(0022001D; 
(0022001E; 
(0022001F; 
(00220020 
(00220021 
(00220022 



warning: tape not at load-point 

warning: tape unit is offline 

invalid mt unit number 

invalid mode field 

invalid buffer length 

invalid parameter 

no PNA board installed in system 

magtape unit is not connected 

magtape not acquired 

magtape unit is not read^ 

unit will not fit thru 25" hatch 

magtape unit in use 

magtape not initialized 

magtape already acquired 

invalid option 

too many outstanding operations 

invalid buffer address 

invalid count for erase or space operation 

tape drive is hung 

ppn list overflow - internal error 

conf ig page in use - internal error 

release problems - internal error 

unexpected interrupt 

operation attonpted before waiting 

wait attempted before go issued 

go command issued while not in batch mode 

header or buffer misalignment on chained r/w 

user quit vdiile in mt_$wait 

timeout during wait or release 

header buffer not on header page 

no room from mt_$write - internal error 

info array (passed to rat_$wait) too small 

too many pages wired 

too many pbu devices in use 

buffer already wired 

buffer not wired 



OS / ACL manager: 

(00230001) no right to perform operation 

(00230002) insufficient rights to perform operation 

(00230003) exit_super called more often than 

enter_super 

(00230004) wrong type - operation illegal on systan 

objects 

(00230005) entry already exists 

(00230006) ACL is remote 

(00230007) ACL is on different volume than object 

(00230008) ACL protects wrong type of ctoject 
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(00230009) insufficient address space to open ACL 

(0023000A) entry was matched by a wild card 

(0023000B) no entry - entry nuitber too large 

(0023000C) iitage buffer too snail or incorrect size 

(0023000D) ACL object not found 

(0023000E) ACL would be unchangeable 

(0023000F) object may not be readable by backup 
procedure 

OS / PEB nanager: 

(00240001) fpu is hung 

(00240002) PEB interrupt 

(00240003) floating point overflow 

(00240004) floating point underflow 

(00240005) divide by zero 

(00240006) floating point loss of significance 

(00240007) floating point hardware error 

(00240008) attonpted use of unimplanented opcode 

(00240009) wcs verify failed 



OS / network logging manager: 
(00250001) ppn list overflow 

OS / color display nanager: 

(00260001) illegal caller 

(00260002) too many wired pages 

(00260003) virtual address not page aligned in 

color_Smap 

(00260004) pages unmapped out of order 

(00260005) parameter value out of range 

(00260006) color display not available 

(00260007) instruction queue done wait timed out 



Streams Modules: 

(OlOlxxxx) stream 

(0102xxxx) stream 

(0103xxxx) stream 

(0104xxxx) stream 

(OlOSxxxx) stream 

(0106xxxx) stream 

(0107xxxx) stream 

(OlOSxxxx) stream 

(0109xxxx) stream 

(OlOAxxxx) stream 

(OlOBxxxx) stream 

(OlOCxxxx) stream 

(OlODxxxx) stream 

(OlOExxxx) stream 

(OlOFxxxx) stream 

(OllOxxxx) stream 

(Olllxxxx) stream 

(0112xxxx) stream 

(0113xxxx) stream 

(0114xxxx) stream 

(0115xxxx) stream 



manager 


/ open 


manager 


/ create 


manager 


/ get_rec 


manager 


/ get_prior rec 


manager 


/ seek 


manager 


/ createjiere 


manager 


/ truncate 


manager 


/ put_rec 


manager 


/ replace 


manager 


/ put_chr 


manager 


/ close 


manager 


/ delete 


iranager 


/ inquire 


manager 


/ redefine 


manager 


/ open_rec 


manager 


/ pad_create 


manager 


/ memory manager 


manager 


/ get_conditional 


manager 


/ internal module 


manager 


/ get_ec 


manager 


/ internal module 




get_fcb.sfcb 
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(0116XXXX) stream manager / iafeernal module 

get_fcb.pfcb 

(OllTxxxx) stream manager / fork 

(OllSxxxx) stream manager / dup 

(0119xxxx) stream manager / get_buf 

(OllAxxxx) stream manager / alloc_sh_sk 

(OllBxxxx) stream iianager / free_sh_sk 

(OllCxxxx) stream manager / init_shL_sk_pool 

(OllDxxxx) stream manager / bypass 



Streams 

(OlxxFFFB) warning: new name added but can't delete 

old name 
(OlxxFFFC) warning: fix Igth recs & partial rec at EOF 
(OlxxFFFD) warning: close anomaly 
(OlxxFFFE) inquire warning - object open on multiple 

streams 
(OlxxFFFF) warning: file trouble flag is set 
(OlxxOOOO) unused 

(OlxxOOOl) operation attonpted on unopened stream 
(01xx0002) attempted operation illegal on this stream 
(01xx0003) "from" stream not open on switch request 
(01xx0004) no available target stream for switch 
(OlxxOOOS) can't switch - no available stream ids 
(01xx0006) can't open stream to this object type 
(OlxxOOO?) no more available streams 
(OlxxOOOS) requested object is in use 
(01xx0009) end of file 
(OlxxOOOA) ran out of address space 
(OlxxOOOB) permanent files must have names 
(OlxxOOOC) "put" of wrong length record 
(OlxxOOOD) internal fatal error; table re-verify failed 
(OlxxOOOE) parameter combination illegal for this 

stream operation 
(OlxxOOOF) operation illegal with variable length 

records 
(OlxxOOlO) bad position in relative record seek - 

cur. pos, not aligned on record boundary 
(OlxxOOll) attanpt to seek beyond beginning of file 

(key=0?) 
(01xx0012) bad character seek (to before start of 

current record) 
(OlxxOOlS) bad open_XP - must be already open on 

stream elseviiere 
(01xx0014) count field for current record is in error 
(OlxxOOlS) name not found 

(OlxxOOie) bad file header - CRC doesn't check 
(OlxxOOl?) bad location parameter in create call 
(OlxxOOlS) inquire error - can't open stream to this 

type of object 
(01xx0019) object already open on another stream by a 

different name 
(OlxxOOlA) stream id out of range 
(OlxxOOlB) unused 

(OlxxOOlC) object not found even though name exists 
(OlxxOOlD) unused 
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(OIxxOOIE: 

(OlxxOOlF 

(01XX0020 
(01XX0021 
(01XX0022 
(01xx0023 
(01XX0024 
(01xx0025 
(01xx0026 
(01XX0027 
(01xx0028 

(01xx0029 
(01xx002a: 

(01xx002B; 

(01xx002C; 
(01xx002D; 
(01xx002E 
(01xx002F 
(01xx0030 
(01xx003i: 

(01XX0032 

(01xx0033: 

(01xx0034 
{01xx0065 

(01xx0066 

(01xx0067 
(01XX0068: 
{01xx0069 



illegal pad close - must close input pad 

first 
attempted name change would require file 

move 

object deleted vrtiile open on this stream 
name required - open with no name is illegal 
EOF pad put error - "put" legal only at EOF on pads 
bad related pad - invalid or not open 
unable to lock needed resources 
this object type is illegal for pad create 
internal memory management error - fatal 
attempted write to read only stream 
replace length error; record size cannot 

change 
cannot redefine this attribute for a pad 
something failed (inq/redef err_jtask not 

empty) 
illegal attempt to open stream to remote 

device 
no access rights to object 
insufficient rights to object 
invalid data in write to pad 
internal table space error 
move mode is needed - forced locate is on 
illegal forced locate request - legal only 

for disk files 
no more shared file cursors available on 

this node 
internal error: shared file cursor has bad 

reference count (below zero) 
— (01xx0064) unused 
impl. restr.: char seek outside of current 

record illegal 
impl. restr.: either record length or 

offset must be <= 65535 
creation of edit pads unimplemented 
client side pad create unimplemented 
inquire for this object type not yet 

implemented 



display manager / DM process: 

(02010001) Comnand syntax error 

(02010002) Unknown comirand name 

(02010003) Too many comnand arguments 

(02010004) Position specification syntax error 

(02010005) Key definition incomplete 

(02010006) File not found 

(02010007) Unable to access file 

(02010008) Text is read-only 

(02010009) No text under cursor 
(0201000A) Too many windows 
(0201000B) Too many pads 

(0201000C) Display manager internal error #1 

(0201000D) Unable to write new file 

(0201000E) You must finish current command input 
request before naking another 
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(0201000F) Key definition too long 

(02010010) Cursor is not in any window 

(02010011) Line too long - truncated 

(02010012) CC comnand requires position iterk 

(02010013) Unable to create new process 

(02010014) Unable to create new pad 

(02010015) Input pads cannot be replicated 

(02010016) Bad font file 

(02010017) Font table full 

(02010018) Unknown function key name 

(02010019) Window too snail for any text 
(0201001A) Display manager internal error #2 
(0201001B) Pad deleted by client process 
(0201001C) Pad still active 

(0201001D) Illegal grow coordinates 

(0201001E) Display manager pads cannot be named 

(0201001F) File is not an ascii file 

(02010020) Processes still active 

(02010021) Bad text range 

(02010022) Paste buffer empty 

(02010023) Invalid regular expression pattern 

(02010024) Pattern too long 

(02010025) Illegal substitution expression 

(02010026) No match 

(02010027) IM input window cannot be deleted 

(02010028) No room for more text at that position 

(02010029) Invalid hexadecimal digit 
(0201002A) Invalid tabstop value 
(0201002B) Edit pad already open on that file 
(0201002C) File already modified 

(0201002D) No window selected for grow or move 

(0201002E) Line contains non-editable controls 

(0201002F) Cannot delete .bak file 

(02010030) Heap file inconsistent during recovery 

(02010031) Process name already exists 

(02010032) Search aborted 

(02010033) Operation illegal during search or 

substitute 

(02010034) Argument value out of range 

(02010035) User logging out 

(02010036) Error processing user_dataAey_defs 

(02010037) Previous fatal error prevents typing 

(try m -R) 

(02010038) Nothing left to UNDO 

display manager / Heap nanager: 

(02020001) heap table full 

(02020002) invalid length for heap get 

(02020003) invalid heap return 

(02020004) heap space already free on return 

display manager / Pad manager: 

(02030001) stream is not a pad 

(02030002) input pad required for this operation 

(02030003) stream id out of range 

(02030004) operation attempted on unopened stream 
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(02030005) transpript pad required for this operation 

(02030006) pad not in raw mode 

(02030007) value out of range 

(02030008) too nany fonts loaded in this pad 

(02030009) error loading font file 
(0203000A) unknown function key name 

(0203000B) only one input pad allowed per transcript 

(0203000C) illegal parameter combination 

(0203000D) existing pad must be an ascii file 

(0203000E) operation illegal with > 1 client process 

process manager / process manager: 

(03010001) invalid parameters to pTL_$invoke 

(03010002) process had a fatal error 

(03010003) no space for Known Global Table 

(03010004) process alreac^ named 

(03010005) process has no name 

(03010006) error initializing global read/write storage 

(03010007) error allocating PFM error mask 

(03010008) too nany libraries — table space exceeded 

(03010009) mark/release list full 

process manager / loader: 

(03030001) too many undefined globals 

(03030002) object module has too many sections 

(03030003) not enough address space to copy procedure 

(03030004) file is not an object module 

(03030005) object module format version is obsolete 

(03030006) not enough address space to map procedure 

(03030007) not enough address space for static storage 

(03030008) Known-Global-Table is full 

(03030009) reference to undefined global 
(0303000A) library contains unresolved global (s) 
(0303000B) peb required to execute this object module 



process manager / process fault manager: 

(03040001) cleanup handler released out of order 

(03040002) invalid cleanup record 

(03040003) cleanup handler established successfully 

(03040004) pfnL_$cleanup_set was signalled 

(03040005) no rws space to create static cleanup 

handler 

(03040006) static cleanup handler not found 

process manager / program manager: 

(03050001) argument does not exist 

(03050002) argument is too big for supplied buffer 

(03050003) stream vector is too large (>8) or permutes 

streams 

(03050004) not a program 

process manager / mapped segment itanager: 

(03060001) unsupported access rights requested 

(03060002) attonpt to release segment mapped by 

previous level 

(03060003) no object mapped at virtual address supplied 
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(03060004) object already locked in a way that 

precludes your requested use 

(03060005) no space 

(03060006) bad length 

process manager / r/w storage manager: 
none 

US / file utility: 

(04010001) object must be a leaf 

(04010002) unrecognized sys_type returned from 

f ile_$attr ibutes 

(04010003) unrecognized entry type returned from 

naming server 

(04010004) unable to replace or delete a syston 

directory 

(04010005) compare failed 

(04010006) destination directory is contained within 

source directory 

(04010007) can't copy a file or tree to itself 

(04010008) source and destination are on different disk 

volumes 



US / print utility: 

(04020001) /sys/print is not a link! 

(04020002) print queue directory specified by link was 

not found 

(04020003) file to be printed is not an ascii text file 

US / DB: 

(04030001) normal exit from debugger 

US / object module 10: 

(04040001) too many 10 channels in use 

(04040002) channel is not open 

(04040003) get or put outside file 

(04040004) ran out of free read/write storage 



US / TU58 
(04050001) 
(04050002) 
(04050003) 
(04050004) 
(04050005) 
(04050006) 
(04050007) 
(04050008) 
(04050009) 
(0405000A) 



tape: 
bad block nuirber 
invalid op code 
motor stopped 
seek error 
data check 
write protected 
no cartridge 
bad unit number 
end of tape 
failed self-test 



US / sio: 

(04060001) object on this stream is not sio line 

(04060002) bad option parameter 

(04060003) illegal stream id 

(04060004) stream not open 
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us / pattern matcher: 

(04070001) too nany tag specifiers ("{ }") 

(04070002) tcx) nany end-tag characters ("}") 

(04070003) missing end-class character ("]") 

(04070004) invalid use of closure ("*") 

(04070005) missing end-tag character ("}") 

(04070006) pattern too big to fit in supplied buffer 

(04070007) invalid escape sequence 

(04070008) bad pattern 

(04070009) given string and pattern do not match 
(0407000A) output string too small 

US / wildcard processor: 

(04080001) can't get free space for pathname 

(04080002) invalid wildcard length 

(04080003) invalid wildcard name 

(04080004) invalid use of directory closure 

("*" or "+") 

(04080005) too many components 

(04080006) internal error #1 

(04080007) circular link detected 

(04080008) first name found 

(04080009) excess end tags ("}") in wildcard 
(0408000A) missing end tags ("}") in wildcard 

US / font manager: 

(04090001) font table is full 

(04090002) bad font file 

(04090003) unrecognized font version # 

(04090004) bad font id argument 

(04090005) bad value id 

(04090006) character is not in font 

(04090007) free storage space full 

(04090008) character is too large 

(04090009) descriptor or header value is out of range 
(0409000A) invalid character code 

(0409000B) no character image 

(0409000C) font is read-only 

(0409000D) one or more images are required 

(0409000E) font table is full 



US / shell: 

(040A0001) shell program too large: syntax tree space 

full 
(040A0002) shell program too large: token buffer space 

full 
(040A0003) shell programs nest too deeply (may invoke 

itself) 



US / aclm: 
(040B0001) 
(040B0002) 
(040B0003) 

(040B0004) 



no right to perform operation 
insufficient rights to perform operation 
exit_super called more often than 

enter_super 
wrong type - operation illegal on system 

objects 
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(040B0005: 
(040B0006 
(040B0007 
(040B0008: 
(040B0009 
(040B000A; 
(040B000B] 
(040B000C: 
(040B000D: 
(040B000E; 
(040B000F; 

(040B0010: 
(040B0011 
(040B0012 
(040B0013: 
(040B0014 
(040B0015 
(040B0016: 
(040B0017: 
(040B0018 
(040B0019 

US / uvtoc 
(040C0001: 
(040C0002 
(040C0003: 

library / 
(05010001 
(05010002 
(05010003 
(05010004 

(05010005 

(05010006 
(05010007 
(05010008: 
(05010009 
(0501000a: 
(0501000B] 

(0501000c: 

(0501000D 
(0501000E: 
(0501000F 

(05010010: 

library / 
(05020001 
(05020002 
(05020003: 



entry already exists 
ACL is remote 

ACL is on different volume than object 
ACL protects wrong type of object 
insufficient address space to open ACL 
entry was matched by a wild card 
no entry - entry number too large 
image buffer too small or incorrect size 
ACL object not found 
ACL would be unchangeable 
object may not be readable by backup 
procedure 
reserved code 10 
reserved code 11 
reserved code 12 
reserved code 13 
invalid right name 
invalid person identifier 
invalid project identifier 
invalid organization ID 
invalid node ID 
non-existent SID 



object is not a local entry directory 
no available address space 
end of vtoc 

open: 
do not provide name for SCRATCH file 
need name of file to open 
invalid STATUS= option 
direct access not allowed with variable 

length records 
given record length is not compatible with 

this file 
need record length > zero 
invalid ACCESS= option 
invalid FOM= option 
invalid UNIT= specifier 
no space to create requested 10 unit 
FOM= option value not compatible with this 

file 
BLANK= option not allowed for unformatted 

file 

invalid BLANK= option 

unrecognized special name beginning with "-" 
comorand line arguments are named "1 thru ^^9 
file not found 

close: 
KEEP status not allowed for SCRATCH file 
invalid STATUS= option 
can't delete file 
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library / itark/release : 

(05030001) cannot find old Fortran lO state record 

library / 10: 

(05040001) no space to create 10 unit 

(05040002) unit is not connected 

(05040003) recursive use of FORTRAN 10 

(05040004) direct access not allowed to sequential file 

(05040005) need record number for direct access 

(05040006) invalid option (s) used to reference internal file 

(05040007) feature not implepnented yet 

(05040008) end of file 

(05040009) unformatted operation not allowed on file 

opened for formatted 10 
(0504000A) formatted operation not allowed on file 
opened for unformatted 10 

library / 10 transfer: 

(05050001) Internal format error 

(05050002) No edit specifier in format 

(05050003) Improper character in input data 

(05050004) Real exponent too large 

(05050005) Improper format descriptor for variable type 

(05050006) Data overflovvs buffer size 

library / read: 

(05060001) end of file 

(05060002) record is larger than available buffer 

library / write: 
(05070001) nyi 

library / position: 

(05080001) no space to create unit 

(05080002) unit is not connected 

(05080003) recursive 10 

library / floating point: 

(05090001) overflow in add/sub 

(05090002) underflow in add/sub 

(05090003) loss of significance in add/sub 

(05090004) overflow in multiply 

(05090005) underflow in multiply 

(05090006) overflow in divide 

(05090007) underflow in divide 

(05090008) division by zero 

(05090009) overflow in convert to word integer 
(0509000A) overflow in convert to long integer 
(0509000B) overflow in dp add/sub 
(0509000C) underflow in dp add/sub 
(0509000D) loss of significance in dp add/sub 
(0509000E) overflow in dp multiply 
(0509000F) underflow in dp multiply 

(05090010) overflow in dp divide 

(05090011) underflow in dp divide 

(05090012) dp division by zero 
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(05090013) overflow in c»nvert double to single 

(05090014) underflow in convert double to single 

(05090015) square root of a negative number 

(05090016) overflow in exp function 

(05090017) overflow in dp exp function 

(05090018) arg of log function less than or equal to 

zero 

(05090019) dp arg of log function less than or equal to 

zero 



library / inquire: 



(050A0001 
(050A0002 
(050A0003 

library / 
(050B0001 
(050B0002 
(050B0003 
(050B0004; 

(050B0005: 
(050B0006 
(050B0007 
(050B0008: 

library / 

(Osocffff; 

(050C0001 
(050C0002 
(050C0003 
(050C0004 
(050C0005 
(050C0006 
(050C0007 
(050C0008 
(050C0009 
(050C000A: 
(050C000B; 
(050C000C 
(050C000D 
(050C000E; 
(050C000F 
(050C0010 
(050C0011 
(050C0012 
(050C0013 
(050C0014: 

(050C0015 
(050C0016 
(050C0017 
(050C0018 
(050C0019 

(osocooia; 



cmd line args are named '^1 thru ''9 

recursive io 

target string too snail 

format : 

left parenthesis expected 

right parenthesis expected 

period expected 

comma r colon, slash, or right parenthesis 

expected 
unsigned integer constant expected 
p format not followed by f, e, 6, or g 
bad holler ith or character constant 
unrecognized format specifier 

tfp: 

computed block count doesn't match that in 

EOF label 
volume not found 
volume not open 
volume already open 
file not open 
file already open 
file not found 
tape i/o error 
end of volume encountered 
invalid file section value 
invalid file sequence value 
invalid generation nuirber value 
invalid generation version number value 
invalid block count value 
invalid block length value 
invalid record length value 
invalid buffer offset value 
no tcb is available (internal table full) 
invalid unit nunber 

first label on volume is not VOLl label 
label version nunber in VOLl label is not 

"3" 
tape drive is already in use by this process 
end of file 

tape limit: eot/bot itarker encountered 
label size is in error; not 80 characters 
block size is too large 
invalid record format specifier 
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(050C001B] 

(050C001C 

(050C001D; 
(050C001E 
(050C001F 
(050C0020: 

(050C0021: 

(050C0022: 

(050C0023 

(050C0024 
(050C0025; 
(050C0026 
(050C0027 
(050C0028: 
(050C0029 

(050C002A; 

(050C002B; 

(050C002C: 

(050C002D; 

(050C002E: 

(050C002F 

(050C0030 
{050C0031 
(050C0032: 

(050C0033; 
(050C0034: 
(050C0035 
(050C0036 
(050C0037 
(050C0038; 
(050C0039: 
(050C003A: 
(050C003B] 

(050C003C 
(050C003D: 

(050C003E 
(050C003F: 
(050C0040 
(050C0041 
(050C0042 



unlabeled operation attonpted on a labeled 

volume 
labeled operation attempted on an unlabeled 

volume 

invalid volume id 
conflicting blocking information 
file does not exist on this volume 
internal or exception procedure returned bad 

new-volume info 
a HDRl label is missing where one is 

required 
an BOFl (or EOVl) label is missing where one 

is required 
a double f ilemark was encountered 

unexpectedly 

inconsistent file sequence nuirbers 
file sequence number tracking error 
read attempted on file open for writing 
write attempted on file open for reading 
block list size is invalid 
an EOVl (or EOPl) label is missing where one 

is required 
wrong volume, file header is inconsistent 

with previous trailer 
operation not started due to error in 

previous block list 
record i/o attenpted on volume open for 

block i/o only 
variable record with invalid record control 

word encountered 
spanned record with invalid segment control 

word encountered 
erroneous spanning indicator or segment out 

of sequence encountered 
invalid mode set passed to tfp_$set_jnDde 
invalid environment for mt /Status required 
more info returned from mt_$wait that 

expected 
attonpt to enqueue too neny operations 
magtape is offline or f lo^jy is not ready 
wait not performed before go 
go called with no work to do 
invalid operation code 
OS magtape manager out of pb's 
wait called when not required 
OS magtape manager didn't purge ops on error 
# ops executed does not match # ops 

completed 

i/o error recovery failed 
invalid recovery value returned by 

execption handler 
zero length block list unexpected 
tape rewind error 
tape space-record error 
tape space-f ilemark error 
tape write-f ilemark error 
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(050C0043 
(050C0044: 
(050C0045; 
(050C0046 

(050C0047 
(050C0048; 

library / 
(OSODOOOi; 
(050D0002: 
(050D0003 
(050D0004 
(050D0005: 
(050D0006 
(050D0007 
(050D0008; 
(050D0009 
(050D000A; 

library / 
(OSOEOOOi; 
(050E0002 
(050E0003 
{050E0004: 
(050E0005 
(050E0006 
(050E0007 
(050E0008: 
(050E0009: 
(050E000A1 
(050E000B] 
(050EOOOC 
(050E000D; 
(050E000E 
{050E000F 
(OSOEOOlO: 
(OSOEOOli: 
(050E0012 
(050E0013 
(050E0014 
(050E0015 
(050E0016 
(050E0017 
(050E0018; 
(050E0019; 
{050E001A; 

library / 
(OSOFOOOi; 
(050F0002: 
(050F0003 

library / 
(0510FFFE; 
(0510FFFF: 



tape or floppy is write-protected 
redundant call to wire i/o buffers 
attenpt to already-unwired i/o buffers 
unable to re-open volume; current position 

is unknown 
unable to re-open volume; info file is bad 
tape read-foreign error 

Pascal 10: 

too many open files 

use of unopened file 

REWRITE required before writing to file 

RESET required before reading from file 

read past end of file 

real exponent too large 

invalid operation on file 

invalid OPEN parameter 

inconsistent file usage 

invalid read data 

MBX iranager: 

size parameter too large 

size parameter too snail 

too many channels 

illegal mbx handle 

file already in use 

no room in channel 

msg too big for channel 

no active servers 

open rejected 

end of file 

no available channels 

channel not open 

unexpected control message received 

renote transmit failed 

remote reply wait timed out 

ronote service currently unavailable 

invalid mbx handle 

wrong mbx version number 

unknown remote request 

remote service denied 

channel empty 

supplied buffer too small 

record was truncated 

no more resources available 

bad key 

returned data does not complete a record 

ptx plot package: 

image too small in the x-dimension 
image too small in the y-dimension 
invalid value for horizontal start 

floppy seq i/o manager: 
warning: record truncated 
warning: disk almost full 
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(05100001 
(05100002 
(05100003 
(05100004 
(05100005 
(05100006 
(05100007 
(05100008: 
(05100009; 
(0510000A] 

(0510000B) 
(0510000c: 
(0510000D: 
(0510000E; 

(0510000F 
(05100010 

(05100011 
(05100012 
(05100013 



invalid floppy unit # 

floppy is full 

control block is too large 

end of file 

end of tape 

unit is already open 

unit is not open 

attenpted write on read-only floppy 

invalid narker specification 

data error: filler expected v^ere none was 

found 
data error: filler found where not expected 
data error: invalid control code 
data error: record trailer missing 
data error: record trailer doesn't match 

header 
beginning of tape 
data error: beginning of tape found v^ere 

unexpected 

floppy is physically write-protected 
floppy is not ready 
invalid label record — probably not written 

with WBM 



library / 
(05110001 
(05110002 
(05110003 
(05110004 
(05110005 
(05110006: 
(05110007: 
(05110008 
(05110009 
(05110CuA; 

(0511000b; 
(0511000c; 

(0511000D; 
(0511000E; 
(0511000F 
(05110010 
(05110011 
(05110012 
(05110013 
(05110014 
(05110015 
(05110016: 
(05110017: 

library / 
(05120001 
(05120002 
(05120003 
(05120004 
(05120005 



Ethernet driver: 

controller does not exist 

invalid ethernet controller number 

controller not online 

invalid buffer size parameter 

invalid statistics type 

invalid mode parameter 

invalid options parameter 

illegal number of addresses 

address is not a valid group address 

no receive available 

quit v^ile waiting 

receive packet truncated 

too many collisions 

device timed out 

operation failed 

internal frame header invalid 

internal dma length error 

unexpected status from device 

NMIO scratchpad test failed 

NIVIIO dma test failed 

NMIO transmitter test failed 

NMIO receiver test failed 

NMIO loojtiack test failed 

versatec driver: 

invalid action code 

invalid buffer size 

no PBU or Versatec controller is installed 

device is offline 

device is out of paper 
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library / pipe nanager: 

(05130001) supplied buffer too large 

(05130002) pipe is empty 

(05130003) pipe is full 

(05130004) illegal pipe operation 

(05130005) pipe has no readers 

(05130006) pipe has no writers 

library / amlc manager: 

(05140001) controller does not exist 

(05140002) bad unit nunfcer 

library / streams-magtape manager: 

(05150001) object is not a magtape file descriptor 

(05150002) magtape file descriptor contains invalid 

data 

(05150003) invalid attribute specifier 

(05150004) invalid creation/expiration date 

(05150005) invalid record format 

(05150006) descriptor file is read-only 

(05150007) invalid unit number 

(05150008) invalid file sequence nuittier 

(05150009) invalid file section number 
(0515000A) invalid block length 
(0515000B) invalid record length 
(0515000C) invalid generation number 
(0515000D) invalid generation version number 
(0515000E) invalid buffer offset 

graphics / primitives: 

(06010001) Primitives not initialized 

(06010002) Primitives already initialized 

(06010003) Wrong display hardware 

(06010004) Operation illegal for DM frame 

(06010005) Must borrow display for this operation 

(06010006) No attributes defined for bitmap 

(06010007) No more bitmap space available 

(06010008) Dimension too big 

(06010009) Dimension too small 
(0601000A) Bad bitmap descriptor 
(0601000B) Bad attribute block descriptor 
(0601000C) Window origin out of bitmap bounds 
(0601000D) Source window origin out of bitmap bounds 
(0601000E) Destination window origin out of bitmap 

bounds 

(0601000F) Invalid plane number 

(06010010) Cannot deallocate this bitmap 

(06010011) Coordinate value out of bounds 

(06010012) Invalid color map 

(06010013) Invalid raster operation value 

(06010014) Bitmap is read-only 

(06010015) Internal error 

(06010016) Font table is full 

(06010017) Bad font file 

(06010018) Invalid font id 
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graphics / TM support: 

(06020001) Invalid bitmap address 

(06020002) Invalid bitmap length 

graphics / core graphics: 

(06030001) 3D inquiry function needed 

(06030002) Count parameter or array size is less than 1 

(06030003) Array size is less than 3 

(06030004) There is no selected view surface 

(06030005) Inconsistant viewing specification 

(06030006) A segment is currently open 

(06030007) There is no open segment 

(06030008) Color attribute not supported by view 

surface 

(06030009) Intensity attribute not supported by view 

surface 

(0603000A) Requested linestyle attribute not supported 

(0603000B) Requested linewidth attribute not supported 

(0603000C) Requested pen attribute not supported 

(0603000D) Requested font not supported 

(0603000E) String contains undefined characters 

(0603000F) Charplane and charup vectors are parallel 

(06030010) Requested marker symbol not supported 

(06030011) There already is an open segment 

(06030012) The requested retained segment name already 

exists 

(06030013) Current image transformation is of wrong 

type 

(06030014) There is no open retained segment 

(06030015) There is no retained segment matching given 

name 

(06030016) There alreac^ exists a segment with given 

name 

(06030017) There is no open temporary segment 

(06030018) One or more of the attribute values is 

invalid 

(06030019) All charplane normal components are zero 
(0603001A) All charup components are zero 
(0603001B) Image transformation type is invalid 
(0603001C) Image transformation higher type than 

requested 
(0603001D) Segment image xform type not compatible with 

inq 
(0603001E) Segment image xform type higher than inquiry 
(0603001F) Maximum less than minimun value (2D) 

(06030020) View up vector components both equal zero 

(06030021) Program has already set NDC space 

(06030022) NDC default space has already been 

established 

(06030023) A parameter is not in NDC system : 0->l 

(06030024) Neither width nor height is equal to 1 

(06030025) Width or height is equal to zero 

(06030026) Viewport corner outside of NDC space 

(06030027) A 3D viewing function was needed, not 2D 

(06030028) Specified NDC position is outside viewport 

(06030029) The world coordinate xform is not invertible 
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(0603002a: 

(0603002b; 

(0603002C 
(0603002D; 
(0603002E 
(0603002F 



(06030030 
(06030031 

(06030032 

(06030033 

(06030034 

(06030035 
(06030036! 

(06030037 
(06030038: 
(06030039 

(0603003A) 
(0603003b: 
(0603003c: 
(0603003d: 
(0603003E: 
(0603003F: 
(06030040: 
(06030041 
(06030042: 
(06030043 
(06030044: 
(06030045: 
(06030046 
(06030047: 
(06030048: 
(06030049 
(0603004a; 
(0603004b: 
(0603004C 
(0603004D 
(0603004E 
(0603004F: 
(06030050 
(06030051: 
(06030052: 
(06030053: 
(06030054 
(06030055: 
(06030056 
(06030057: 
(06030058 



World coordinate position outside clipping 

window 
All 3 components of view plane noriral are 

zero 
Front distance is greater than back distance 
Parallel projection and direction components = 
Window maximum less than window minimum 
All 3 viewup normal vector components are 

= 
Maximum less than minimun value (3D) 
Projection of world coord, position outside 

window 
World coordinate position in front of clip 

plane 
World coordinate position in back of clip 

plane 
World coord, position behind center of 

projection 
Coordinate systan type has already been set 
Too late - viewing established or segment 

exists 
View plane normal and viewup vector parallel 
Front plane not betweai cop and back plane 
Direction of projection aparallel to view 

plane 
Center of projection on or behind view plane 
Front and back clipping planes coincident 
Device already initialized 
Device class or device number is invalid 
Device class is invalid 
Array contains invalid device number 
Device is not initialized 
Device is alreadjj^ enabled 
Member of group not initialized 
Device is not enabled 
Locator device not enabled 
Valuator device not enabled 
Time parameter is less than zero 
Event device not initialized 
Invalid event device class 
Association already exists 
Event class is invalid 
One or both devices not initialized 
Association does not exist 
Event report not from pick device 
Event r^xDrt not from ke^xard device 
Event report not from stroke device 
Needed 3D input function 
Locator not enabled or associated 
Valuator not enabled or associated 
No button devices are initialized 
Specified pick device not initialized 
Specified keyboard device not initialized 
Specified stroke device not initialized 
Specified locator device not initialized 
Specified valuator device not initialized 
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(06030059 
(0603005a; 

(0603005B] 

(0603005C 
(0603005D 
(0603005E 
(0603005F 
(06030060 
(06030061: 
(06030062 
(06030063 

(06030064: 
(06030065: 
(06030066 
(06030067: 
(06030068; 
(06030069: 
(0603006a: 
(0603006b: 
(0603006c; 
(0603006D; 
(0603006E; 
(0603006F 

(06030070: 
(06030071 
(06030072 
(06030073; 
(06030074 
(06030075 
(06030076 
(06030077 
(06030078; 
(06030079; 
(0603007a: 
(0603007b: 

(0603007c; 
(0603007D' 
(0603007E: 
(0603007F 
(06030080 
(06030081 
(06030082 
(06030083 
(06030084 
(06030085 
(06030086; 
(06030087; 
(06030088 
(06030089 
(0603008a: 
(0603008B] 



Echo type is invalid for specified class 
Specified device does not accept echo 

segment 
Image xf orm of segment incompatible with 

echo type 
Echo position outside of NDC space 
Pick aperature is less than or equal to zero 
Buffer size out of bounds 
Cursor start position out of bounds 
Initial string contains undefined characters 
Specified button device is not initialized 
Distance or time less than or equal to zero 
Specified locator position outside of NDC 



Maximum less than minimun (3D) 
Locport corner outside of NDC space 
Low value is greater than high value 
Initial value not within defined range 
Associated size less than or equal to zero 
Duplication size less than or equal to zero 
Core has already been initialized 
Specified output level cannot be supported 
Specified input level cannot be supported 
Specified dimension cannot be supported 
View surface is alreac^ initialized 
No output device associated with view 

surface 
No other view surface can be initialized 
View surface is not initialized 
View surface is already selected 
View surface cannot be selected 
View surface has not been selected 
Immediate visibility state is invalid 
Currently in batch of updates 
Not in batch of updates 
Element of segment array does not exist 
Invalid visibility array elonent 
Core has not been initialized 
Function at a higher level than current 

suppory 
Invalid error log invocation 
Function is not supported 
Parameter count is incorrect 
One or more parameters invalid 
Vertex array is too sitall 
Intensity value is invalid 
Color value is invalid 
Specified table range is invalid 
Low or high table index is invalid 
Low table index is greater than high 
Too few values to fill specified range 
Invalid intensity array elonent 
Invalid color array elanent 
Origin outside NDC space 
Array size invalid 
Array row invalid 
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(0603008c: 
(0603008D: 
(0603008E; 
(0603008F: 
(06030090 
(06030091 
(06030092 
(06030093 
(06030094 
(06030095 
(06030096; 
(06030097; 
(06030098 
(06030099 
(0603009A: 
(0603009B] 

graphics , 
(06040001 
(06040002 
(06040003 
(06040004 
(06040005 



(07010001 
(07010002 
(07010003 
(07010004 
(07010005 
(07010006; 
(07010007 
(07010008 
(07010009 
(0701000a: 
(0701000b: 
(0701000c: 



Array column invalid 

Invalid parameter value 

View surface is initialized to intensity 

Invalid index value 

Shading vertex misiratch 

Vertices not coplanar 

Less than three vertices received 

Index range is too large 

Table is too small 

View surface is of type color 

View surface is of type intensity 

There is no hidden surface support 

The specified mode is invalid 

View surface is initialized 

Invalid view surface type parameter 

Input currently not supported in frame mode 

metafile manager: 
Bits/inch parameter is negative 
X dimension is not positive 
Y dimension is not positive 
Words/line parameter is too small 
Position parameter is illegal 



registry manager / PBO supervisor: 



Name not defined 
Name already defined 
Name is too long 

Incompatible program and file versions 
No more memory space available 
File open for read, not write 
Invalid file, internal error 
PPO salvage only partially complete 
No valid PPO file found at any registry site 
Name has invalid characters 
Cannot delete reserved name 
Unable to access ppo file at any registry 
site 



registry manager / Accounts supervisor : 

(07020001) Account not defined 

(07020002) Last entry cannot be deleted 

(07020003) Invalid operation on local registry 

(07020004) Incompatible program and file versions 

(07020005) No more memory space available 

(07020006) File open for read, not write 

(07020007) Invalid file, internal error 

(07020008) Account salvage only partially complete 

(07020009) No valid account file found at any registry site 
(0702000A) Unable to access account file at any 

registry site 

registry manager / Registry supervisor: 

(07030001) Invalid registry file, internal error 

(07030002) Registry already open for that file type 
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(07030003) Registry is open for read. Cannot open for 

write 

(07030004) Index exceeds nuirber of sites in registry 

(07030005) Attempt to open two registries 

simultaneously 

(07030006) Name is not a site in this registry 

(07030007) Site pathname too long, cannot append 

filename 
(97030008) Attempt to delete last site of registry 
(07030009) Invalid pathname 
(0703000A) Full site pathname required for existing 

sites . 



registry manager / Login supervisor: 

(07040001) Shutting down 

(07040002) Exiting 

D3M data managonent / d3mlib: 

(08010001) database not open 

(08010002) dbk for wrong area 

(08010003) database already open 

(08010004) unused 

(08010005) duplicates error 

(08010006) current unknown 

(08010007) end of set or area 

(08010008) unknown name; not in schona 

(08010009) database is open read only 
(0801000A) wrong password 
(0801000B) no disk space 
(0801000C) dbk not available/no good 
(0801000D) unused 

(0801000E) no current of this record type 

(0801000F) set has no optional members 

(08010010) record is already member 

(08010011) violation of concatenated set integrity 

(08010012) unused 

(08010013) unused 

(08010014) current of rec wrong type 

(08010015) current of rununit of wrong type 

(08010016) record not member in set 

(08010017) record not in area 

(08010018) unused 

(08010019) unused 

(0801001A) no record satisfies record selection 

(0801001B) unused 

(0801001C) area already open 

{0801001D) area not open 

(0801001E) delete set not onpty 

(0801001F) internal stack overflow 

(08010020) invalid literal argument 

(08010021) invalid virtual iton 

(08010022) unused 

(08010023) mod var Igth needs 2 bufs 

(08010024) unused 

(08010025) unused 

(08010026) unused 
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(08010027 
(08010028: 
(08010029 
(0801002a: 
(0801002b: 
(0801002c: 
(0801002D: 
(0801002E: 
(0801002F 
(08010030 
(08010031: 
(08010032 
(08010033 
(08010034 
(08010035 
(08010036: 
(08010037: 
(08010038 
(08010039 
(0801003a; 
(0801003B] 
(0801003C 
(0801003D 
(0801003E: 
(0801003F 
(08010040 
(08010041 
(08010042 
(08010043 
(08010044 
(08010045 
(08010046 
(08010047: 
(08010048 
(08010049 
(0801004A 
(0801004b; 
(0801004C 
(0801004D: 
(0801004E 
(0801004F 
(08010050: 
(08010051 
(08010052 
(08010053 
(08010054 
(08010055 
(08010056 
(08010057 
(08010058: 
(08010059 
(0801005A 
(0801005b; 
(0801005C 
(0801005D 
(0801005E 



unused 

findv requires sorted set 
f indc requires calced record 
record not indexed 
unused 

improper set mode 

set, record, etc. not in subscheam 
unused 
unused 
unused 
unused 
unused 

deleted rec referenced 
key relation mismatch 
HLDML call error 
HLDML syntax error 
HLML semantic error 
HEDML execution error from D3MLIB 
unexpected HLDML execution error 
HLDML internal error 
unused 
unused 
close error 
name not found 
file not found 

required resources not available 
end of file 
wrong object type 
unable to open 
bucket initialization error 
unused 

loc mode select required in all sets 
too many sets in path 
multischana inconsistency 
distributed DML operation not supported 
dynamic store error 

violation of distributed set integrity 
unused 
unused 
unused 
unused 

internal bad bucket number 
transaction call err 
active transaction required 
unused 
unused 
unused 
unused 
unused 

UWA is too large; insufficient memory 
schema/subschema confusion 
recompile schema 
read error on (sub)schQna file 
(sub)schana file open err 
database write error 
database read error 



APOLLO CONFIDENTIAL. INTERNAL USE ONLY. 



Error Codes and Messages 



(0801005F) concurrency violation 

(08010060) device unavailable 

(08010061) insufficient virtual memory 

(08010062) must preallocate file (use INEB) 

(08010063) bad bucket adress 

AUX / signal: 

(09010001) hangup fault 

(09010002) interrupt fault 

(09010003) quit fault 

(09010004) illegal instruction fault 

(09010005) trace trap fault 

(09010006) lOT instruction fault 

(09010007) - EMT instruction fault 

(09010008) floating point exception fault 

(09010009) process kill fault 
(0901000A) bus error fault 
(0901000B) segmentation violation fault 
(0901000C) bad argument to system call fault 
(0901000D) broken pipe fault 

(0901000E) alarm clock fault 

(0901000F) software termination fault 

(09010010) user-defined fault (1) 

(09010011) user-defined fault (2) 

(09010012) child death fault 

(09010013) power failure fault 



Error Codes and Messages 
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BO OT E RRORS (P RP M) 



error: bcx>t not found • 



The SYSBOOT read from records 2 
thru B did not have a good 
boot header. 



disk init error 
disk read error 



<SC> 
<SC> 



<RCD> 
<RCD> 



<UNIT> 
<UNIT> 



<W/F> 
<W/F> 



SC = Status Code 
RCD = Record Address 
Unit = Disk Unit No. 
W/F = Winchester/Floppy 

Winchester Status Codes 



Floppy Status Codes 



: 1 


- not responding 


2 


- not ready 


11 


- seek not complete 


12 


- CRC, timeout, buserr. 




overrun 


13 


- drive faults 


1 


- wrong no, of status bytes 


2 


- seek not complete 


3 


- equipment check 


11 


- insufficient status 


12 


- seek not complete 


13 


- equipment check 


14 


- bad seek 


15 


- insufficient status 


16 


- abnormal termination 


17 


_ II II 


18 


- device not ready 


19 


- CRC error 



D IAO P gr i C E R R OR COP ES 



error : 

<test no.Xdetected atXobject addrXdata isXdata ^> 

test 1 = checksum 

" 2 = PFT 

" 3 = PTT 

" 4 = lOMAP 

" 5 = PFT/PTT/IOMAP interactions 

" 6 = First 256KB (^lysical) 

" 7 = " " (mapped) 

' • 8 = " " verify mapping 
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M N EW NIC DEBUGG ER g RPQR CQ PE S iF BO n) 



Printed on syston crash or other entry to MD, See also 
System Crash Analysis under Operational Procedures, 



A <PC> <SR> <IR> <PA> <FC> 

<PC> <Contents> 
B <PC> <SR> <IR> <FA> <FC> 

<PC> <Contents> 



I 
J 


<PC> <SR> 

<BC> <Contents> 


p 
s 

T 
U 
Z 


<PC> <SR> 

<PC> <Contents> 

<PC> <SR> 

<PC> <contents> 

<PC> <SR> 

<PC> <Contents> 

<PC> <SR> 

<PC> <Contents> 




PC = Program Counter 
SR = Status Register 
IR = Instruction Register 



- Address Error 

- Bus Error 

- Operational Error 

- Unexpected Interrupt 

Spurious Interrupt 
Parity error (D^BOO only) 

- Trap instruction or 
breakpoint 

Trace trap 

Unimp inst trap 

- Divide by zero trap 



FA = Fault Address 
FC = Fault Code 



Syston 



SR: IT-S— III I ^XNZVC | 

H H + 

T - Trace Mode 
S - Supervisor Mode 
III - Interrupt Mask 
000 - enabled 
111 - disabled 

15 



X - Extend 
N - Negative 
Z - Zero 
- Overflow 
C - Carry 



-RNFFF I 



R = 1 => Read operation 

N = 1 => Not instruction reference 

FFF - Function code: 



001 
010 
101 
110 
111 



User data 
User program 
Supervisor data 
Supervisor program 
Interrupt acknowledge 
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SYSBQOT ERBQR CODES 



h error: unable to read pv_J.abel 

' ' volume "N" not found 

' ' unable to read lv_label 
" " " " root_dir 

• ' SAU not found in root_dir 

" SAU uid not found 

' • unable to restore SAU_dir 

•• "FILENAME" not found 
" " uid not found 
" ' ' unreadable 
" • • not a file 

' ' missing file name 
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CHAPTER 5 
FILE SYSTEM 



ACLS STRUCTURE 

ACL Header Record 

(type acl_$hdr in acls.pvt.pas) 

15 



H + 

+0 I VERSION OF ACL I 
1 I 


+02 1 
\ 


TYPE OF OBJECT FOR 
WHICH THIS CAN BE ACL 


1 
1 

\ 
1 


-Km 1 I 

1 DEFAULT NODE LIST j 
1 FOR NEW ENTRIES | 
1 1 


-fOE 1 


NUMBER OF ENTRIES 


i 
I 


+10 1 


NUMBER OF NODE LISTS 


1 
1 


+12 1 


NOT USED 


I 
1 


+14 1 
\ 

+34 +-- 


NOT USED 


1 

\ 

1 

+ 



ACL Record 



+0 I 
\ 
I 



.atype 



.def_nil 



(type acl_$rep in acls.pvt.pas) 

15 



+34 I ENTRIES 

I array[l.acl_$entinax] 
I of acl_$entry 
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ACL Entry 

(type acl_$entry in acl.ins.pas) 

64 
+00 
+08 
+10 
+18 
+20 
+28 



1 PERSON UID 1 


1 PROJECT UID I 


I ORGANIZATION UID I 


1 SUBSYSTEM UID | 


1 ^DDE ID 1 EXP DATE | 


I ACL RIGHTS I 

+ 4. 



.pers in acl_$sid 
.proj in acl_$sid 
.org in acl_$sid 
.subs in acl_$sid 
.node_t, .e3Cp_date 
.rights 



BLOCK AVAILABILITY TABLE fBAT) 

(type "batjDlk" in vol. ins. pas) 
type bat_blk_t= array [0.. 255] of bat_lword_t 
31 

H + 

+00 I 



BAT WORD [0] 



I 



+04 I 



BAT WORD [1] 



I 



+3PC I 
+400 -H 



BAT WORD [255] 



First BAT block pointed to by BAT header in logical volume 
label (pv_JLabel) . BAT resides in contiguous records. 

Bit 0, BAT WORD[0] corresponds to first block 
(bat_hdr.base_add) in logical volume. BAT bit = 1 if block 
is available. 



File System 
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(type "bat_Jidr_t" in vol. ins. pas) 

31 



+2C I NUMBER OF BLOCKS REPRESENTED 



+30 I NUMBER OF FEIEE BLOCKS 



+34 I DADDR OF FIRST BAT BLOCK 



+38 IBLK # REP BY 1st BIT IN BAT 



+3C IVCB- 



/ 
I 
+4C +-- 



.ItjDlk 

.Itjree 

.elddr 

.base_add 

.vol_trouble 



V - Volume trouble, set by OS if volume needs 

salvaging, cleared by SALVQL, 
C - Volume chuvoled 
B - Volume being chuvoled 

BAT header lives in logical volume label. 
Offsets given are from start of label. 



PIREgrC^Y STI^CTURE 



Directory Overview 

(type dir_t in name. pvt. pas) 



header 



linear list 



hash threads 



entry 
blocks 



directory configuration 

information 
sequentially used directory 

entries 
ACL manager's intial ACL 

description block 
Pointers to linked lists of 

hashed entries 
Holding blocks for hashed 

entries and/or link text 
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Director y Info Block 

(type infoblkjidrjt in name. pvt. pas) 



+00 

+02 

+04 

+06 

+08 
+0A 

+0C 
+0e 



info blcxnk length 



info block hdr length 



default acl uid 
for directories 



default acl uid 
for files 



+10 

\ 
+30 +■ 



24 unused bytes 



\ 



info block version number 
total length of info block 
length of info blk hdr (8) 
reserved for future use 

uid of acl to be applied to 

directories catalogued in 

this directory 
uid of acl to be applied to 

files catalogued in this 

directory 
reserved for future use 



PirectPiy Entry 

(type dir_entry_t in name. pvt. pas) 



+00 
+20 
+22 
+24 



entry name 



unused 



unused 



unused 



entry type 



4 words of 

entry data 

(either UID or link 

text description) 



32 bytes of entry name 

reserved 

reserved 

reserved 

name len - # of useful 

characters in entry name 
entry type - = not in use 

1 = name/uid pair 
3 = name/link-data 
pair 
if entry type = 1, UID 
entry type = 3, => 
link text: link text len, 
blk holds Ink text chrs, 1-144 
blk holds Ink text chrs, 145-256 
reserved for future use 



File System 
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Directory Entry Block 

(type entryjDlock_t in name. pvt. pas) 
total length - 150 bytes 



+00 
+02 



next block number 



prev block number 



I 

use count I block type 

I 



entry block 
data 



forward thread - doubly linked 

list 
backward thread - doubly linked 

list 
use count - # of used entries 

in this block 
blk type - = not in use 
-1 = hash blk with 3 dir entrs 
-3 = link text holding block 
either 3 dir entries or 
up to 144 chars of link text 



Directory Header 

(first part of type dir_t in name.pvt.pas) 



+00 
+02 
+04 
+06 
+08 
+0A 
+0C 
+0E 
+10 
+12 
+14 
+16 
+18 



version 



hash value 



pool size 



entries per block 



high block number 



free block thread 



unused 



unused 



entry count 



maximum count 



version number of this directory (1) 

# of hash threads used for entry 

name hashing 

# of entries configured into 

linear list (18) 

# of entry blocks in this 

directory (429) 

# of entries that fit in an 

entry block (3) 

# of the highest entry block 

used so far 

# of the first block on the free 

block list 
reserved for future use 

reserved for future use 

reserved for future use 

reserved for future use 



# of ents currently catalogued 

in this directory 

# of entries this directory can 

hold (1300) 
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Itotes on directories 

1. To add an entry to a directory: 

A. Look for an unused entry in the linear list. If 
you find one, use it and you're done. 

B. Hash the name you want to add: 

- name is: 

name: array [1..32] of CHAR 

- Inth is useful Inth of name 

sum: =0; 

For i : = 1 to Inth DO 

sum : = ord(name[i])+2*sum; 
HASH VAL : = sum mod HASH_ VALUE ; 



C. Get the hash thread for the specified hash value 
and call that value the found block. 

D. If the found block number is then we need a new 
entry block, so: 

a) See if there are any blocks threaded 
through the free block list and if so, 
take one of those. Otherwise, bump the 
high block number and use that. 

b) Initialize the newly obtained block, add 
it to the end of the ^pprpriate hash 
chain, add the new entry as the first 
entry in the new eitry block and you're 
done. 



E. If there is an unused entry in the found block, 
use it and you're done. 

F. Change the found block value to the number in the 
current found block's NETX BLOCK field and goto 
step (d) . 

2. The searching rule for a directory is: 

A. Look in the linear list. 

B. Hash the name you're searching for. 

C. Follow the hash thread for the specified hash 
value to the first entry block with that hash 
synonym. 

D. Search all (3) of the entries in the found entry 
block 

File System 5-6 apollo confidential, internal use only. 



E. Follow the "next block number" in the found entry 
block to get a NEW found entry block. If the next 
block number is zero, then return NOT FCUND. 

F. Goto step (d) with the newly found block. 



(type "blk_hdr_t" in base.spo.bbas) 
31 16 15 



+- 
+00 I 



I 



UID OF OBJECT TO WHICH 
BLOCK BELONGS 



PAGE NUMBER IN FILE 



+08 I 
+ 

-Kx: I 

+ 

+10 I BLKTYP I SYSTYP | 



+14 I 

+ 

+18 I 



+1C I 
+20 +- 



DISK ADDRESS 



I .uid 



TIME WRITTEN (clock. high32) | 



I 



.bbage 
.dtm 



.blk_type, 
.spys_type 



I .chksum 



I .daddr 



BLKTYP: - Data block 

1 - Level 1 index block in file map 

2 - " 2 " " - - " 

3 - " 3 " " n " - 

SYSTYP: - File 

1 - Directory 

2 - Systen directory 
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i^ i sK/ y^j wm F ia^f gyr 



PHYSICAL 
VOLUME LABEL 



LOGICAL 
VOLUME LABEL 



BOOT 
FILE 



FREE 
BLOCKS 



FE?EE 
BLOCKS 



LOGICAL VOLUME 
LABEL {2nd COPY) 



NEXT LOGICAL 
VOLUME 



BLOCK 00 OF LOGICAL VOLUME (1 BLOCK) 



BLOCK 01 OF LV (10 BLOCKS) 



BLOCK OB OF LV 



NDTE: all disk addresses (DADDRs) 
are relative to the start of a 
logical volume. 



Badspots may cause the VTOC to be incontiguous and not 
adjacent to BAT. There nay exist dead space between 
logical volumes. 



File Syston 
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FILE MAP 



+- 
+00 I 

+-• 
+04 I 

+08 I 
/ 



+7C I 



+84 
+88 



-> DATA BLOCK 1 
-> DATA BLOCK 2 



-> DATA BLOCK 32 
LEVEL 1 



-+ 



256 
POINTERS 

TO 

LEVEL 2 

BLOCKS 











LEVEL 2 


1 256 I 
1 POINTERS 1 
1 TO 1 
ILEVEL 11 
1 BLOCKS 1 

H + 



> DATA BLOCK 34 

> DATA BLOCK 33 



> DATA BLOCK 288 



Maximum file size = (32+256+256**2+256**3) *1024 bytes 
= 17,247,300,000 bytes. 

File map resides in VTOC and AST entry. 
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RPGiS T ^Y Fo p m r 



(type ppo_$header_t in ppo.ins.pas) 



+0 
+8 



TRANSACTION UID FOR SALVAGING 



C I F IHDR LENINUMBEIR | READ 



+10 I WRITE I 



PW LENlRBC LEN 



+18 I 



.ppo_$xact_uid 



.ppo_$rec_JLen 

.ppo_$spacer 
.ppo_$space2 



C = 1 => committed ( .ppo_$coinmitted) 

F = 1 => local ( .ppo_$locaL_f lag) 

NUMBER - number of entries (,ppo_$nuiTLjentries) 

READ - oldest software that can read this (.ppo_$r_vers) 

WRITE - oldest software that can write new ( .ppo_$w_vers) 

PW LEN - minimum password length ( .ppo_$min_plen) 

PPQ RggQrd 

(type ppo_$record_t in ppo.ins.pas) 

H + 



+00 I 
+ 

+08 I 
+ 

+10 ! 
+ 

+18 I 
+- 

+20 I 
+- 

+28 I 



.ppo_$name 



.ppo_$namlen 
.ppo_$uid 



File System 
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Account Header 

(type acct_$header in acct.ins.pas) 



+00 
+08 
+10 
+18 



TRANSACTION UK) FOR SALVAGING 



C I F IHDR LENINUM ENT| READ 



-|PW LEN IREC LEN 



CLOGEOi TIME PER| UNUSED 



. acct_$xact jiid 



,acct_$exp_period 



C = 1 => coinmitted ( .acct_$conimitted) 

F = 1 => lcx:al ( .acct_$local_jf lag) 

HDR LEN - header length ( .acct_$hdr_len) 

NUM ENT - number of entries (.acct_$nuin_entries) 

READ - oldest software that can read this (.acc±_$r_vers) 

WRITE - oldest software that can write new (.acct_$w_vers) 

PW LEN - minimum password length ( .acct_$min_plen) 

REG LEN - record length ( ,acct_$rec_len) 

Account Record 

(type acct_$record_t in acct.ins.pas) 



+00 I 

+- 
+08 I 



PROJECT UID 



+10 I 



ORGANIZATION UID 



+18 I 

+ 

+20 I 



I .acct_$pers_uid 
-+ 
I .acct_$proj_uid 

I .acct_$org_uid 

I .acct_$pwd 
-+ 
I .acct_$exp_date* 



+28 I- 



-I LAST LOGIN 



- I .acct_$last_login* 



+30 I FLAGS I 

H +- 

+38 I 

\ 

I 
+13 8H 



I HM LN I 



\ .acct_$home 



* local registries only 

FLAGS - set of acct_$invalid (local registries only) 

( .acct_$f lags) 
NODE - node type (local registries only) ( .acct_$node) 
HM LN - home length ( .acct_$home_JLen) 
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RPCTis^iry Record 

(type rgy_$registry_t in rgy.ins.pas) 

^ 1- 

+00 I NUMBER OF PNAMES IN REGISTRY | .rgy_$count 



+04 I LENGTH OF REGISTRY NAME I .rgy_$nlen 



+08 I FIRST PNAME I .rgy_$ent_jiame 

\ \ 



I MDRE LENGTHS AND NAMES AS | 
I INDICATED BY COUNT FIELD I 



First pname is path of original registry, used as lock 
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S^TBEm FItf HPftPER 



(type "streanL_$hdr_rec_t" in sbase.ins.pas) 

31 16 15 

+00 



+04 



HEADEH LENGTH 



VERSION 



C R C 



RECORD LENGTH (SEE BELCM) 



+ .rec_JLgth 



FILE LENGTH (INC. HEADER) 



RESERVED 



+20 +- 



.hdr_lgth, 
.version 
•crc 



.file_Jength 



CRC = -(integer sum of (1+3 thru n longwords)) 
RR - Record type (.rec_typef streanL_$rtype_t) : 

00 - var len w/counts (streartL_$vl) 

01 - fixed length (streaiti_$f2) 

10 - no record structure (streaitL-$undef ) 

A = => Binary, 1 => ASCII (.elb_jElag) 

E = 1 => No automatic type change (.explicit_type) 

S = 1 => File nay have holes (.sparse) 

C = 1 => Carriage control (ASCII only) (.cc) 

CO - Concurrency (.cone, strearrL_$f conc_t) : 

00 - N readers or 1 writer (streairL_$a_or_l) 

01 - N readers and 1 writer (streait\_$n^and_l) 
10 - N readers and N writers (steanL_$rL_and_n) 

RECORD LENCtIH: Record length for fixed 

Maximum length for variable 
for undefined record length 



Stream file header is the first 32 bytes of a 
accessed by the stream interface. 



file to be 
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\ M1QM IDENTIFIER (Ijm) 

("uid_t" in base. ins, pas) 
31 16 15 



I (xccccccccccccccx:ccccccccccccccx:cc i 

H 4 H — + 

iCaX— — I NNMlNNNNNNNNM^NNNNNNl 



C.C - Top 36-bits of clock (16 msec units) 

N..N - Node ID 

UID Hash Algorithm 

X = the four words of the UID XORed together 

INDEX = X mod TABLE_3IZE 

where TABLE_3IZE is the size of the table into v^iich the 
UID is being hashed (e.g., vtoc_hdr.vtoc_size) . 
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UIDiS — iSystem 

(from /os/nuc/uidJList.asm) 

uid_$nil 00000000,0 

acl_$nil 00000100,0 

canned ACL uids (file acls) (0001. xxxx series) 

acl_$fnil 00010000,0 

acl_$fndwrx 0001800F,0 
acl_$f ile_nwrx 00018007 , 

canned ACL uids (directory ACLs) (0002. xxxx series) 

acl_$dnil 00020000,0 

acl_$dndcal 0002801P,0 

acl_$dir_jncal 0002800F,0 

disk structure canned UIDs (0000. 02xx series) 

pv_J.abel_$uid 00000200,0 

lv_label_$uid 00000201 , 

vtoc_$uid 00000202,0 

bat_$uid 00000203,0 

canned object type UIDs (0000. 03xx series) 

records_$uid 00000300,0 

hdr_undef _$uid 000003 01 , 

object_file_$uid 00000302,0 

UNDEP_$uid 00000304,0 

pad_$uid 00000305,0 

input_pad_$uid 00000309,0 

sio_$uid 0000030A,0 

ddf_$uid 0000030B,0 

nibx_$uid 000003 0C,0 

nulldev_$uid 0000030D,0 

D3M_area_$uid 000003 0E,0 

D3M_^ch_$uid 0000030F,0 

pipe_$uid 00000310,0 

uasc_$uid 00000311,0 

directory_$uid 00000312,0 
unix_directory_$uid 00000313,0 

int_$uid 00000314,0 

sysboot_$uid 00000315,0 

canned objects UIDs (0000. 04xx series) 

displayl_$uid 00000400,0 

display2_$uid 00000401,0 

naine_$canned_root_uid 00000308,0 

canned person, project, organization 

and subsystem UIDs (005xx series) 
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canned persons (0000. 050x series) 

acl_$sys_user_uid 00000500,0 

canned projects (0000.054x series) 

acl_$sys_proj_uid 00000540,0 
acl_$login_uid 00000541,0 
acl_$locksmitli_uid 00000542,0 

canned organizations (0000. 058x series) 

acl_$sys_org_uid 00000580,0 

canned subsystems (OOOO.OSCx series) 

acX_$nil_^ubs_uid 000005C0,0 

canned acl type UIDs (0000. 06xx series) 

acl_$file_acl 00000600,0 
acl_$dir_acl 00000601,0 
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(type "lvj.abel_t" in vol. ins. pas) 



+00 
+04 



+B0 
+B4 
+B8 
+BC 
+€0 
+C4 
+C8 
+CC 
+D0 
+D4 
+D8 



LOGICAL VOLUME NAME 



UNIQUE ID OF 
LOGICAL VOLUME 



VTOC HEADER 



TIME LABEL WRITTEN 



-I LAST MOUNTED NODE 



TIME SYOTEM WAS BOOTED 

TIME mis VOLUME WAS MOUMPED 

TIME THIS VOLUME WAS DISMOUNTED 



-I NODE OF LAST SALVAGE 



TIME SALVAGE COMPLETED 



MODE OF SALVAGE I SHUTDOWN STATE 



TIME DUMP STARTED 



TIME DUMP FINISHED 



UID OF CURRENT 
ITEM BEING DUMPED 



CONTINUED ON NEXT PAGE 



.version 
.Itame 



.batjidr 



.vtocjnidr 



. label_wr ite_time 

. last_jtiounted_node 

. ltodejDOOt_tiine 

.inounted_tiine 

. dismounted_time 

.spalvage_node 

.spalvage_time 

. spalvage_jnode , 

. spys_sut_state 
. duinp_start_time 

.duirp_end_tiiTie 

.duinp_cur_uid 
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+E0 
+E4 
+E8 
+EC 
+F0 



+3FC 
+400 



# MINS FROM UTCl NAME OF 



... TIMEZONE I LAST ... 



... VALID TIME I 



BAD SPOT BARRIER* 



BAD SPOT LIST [60] 



BAD SPOT LIST [255] 



I .utc_delta 
-+ .tiinezone_naine 
I .last_valid_tiine 



. bad_spot Jaar r ier 



I .bad_spot_list[60] 



bad_spot_list allocated from end of list. 
* FFFFFFFF -> no continue 

FFFFFFFE -> +P0 is DADDR of c»ntinue block 



File System 
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W\^W m^ ^ — PHYSICAL 

(type "pv_JLabel_t" in vol. ins. pas) 

31 16 15 

+00 



+08 



+30 
+34 
+38 
+3C 



+64 
+68 
+6C 



+94 
+98 



VERSION 



I "A" 



"P" 



VOLUME NAME 



UNIQUE ID 
OF VOLUME 



I DISK TYPE 



TOTAL BLOCKS IN VOLUME 



BLKS PER TRACK ITRACKS PER CYL 



DADDR OF LOGICAL VOLUME [1] 



DADDR OF LOGICAL VOLUME [10] 



ALTERNATE LABEL DADDR [1] 



ALTERNATE LABEL DADDR [10] 



.version, 
.elpollo 



.dtype 

, blocks_per_pvol 

.blocks_per_track 
. tracks_per_cyl 
.lv_list[l] 



.lv_aist[10] 
.ellt_Jv_list[l] 



.ellt_Jv_Jist[10] 



DISK TYPE field describes variants of j*iysical disk, e.g., 
double density. Today there are none, and the field 
contains 0. 
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(type "vtocjDlk_t" in vol. ins 
31 


pas) 






+00 1 - 


-> NEXT BLOCK IN HASH BUCKET 


.ltext_add 


+04 1 


VTOC ENTRY[OI 




.vtoc[0] 


+D0 1 


VTOC ENTRY[1] 






+19C 1 


VTOC ENTRY[2] 






+268 1 


VTX ENTRY[3] 






+334 1 
1 Ann 1 


VTOC ENTRY [4] 




.vtoc[4] 




-or- 






+00 I 


FILE MAP[0] 




.fm[0] 


+80 1 


FILE MAP[1] 






+100 I 


FILE MAP [2] 






+180 1 


FILE MAP [3] 






+200 1 


FILE MAP [4] 






+280 1 


FILE MAP [5] 






+300 I 


FILE MAP [6] 






+380 1 
+400 H 


FILE MAP [7] 




.fni[7] 



When VTOC block contains a file nap, the block is pointed 
to by vtoce.fm2[l-3] (see VTX ENTRY). 



File System 



APOLLO CONFIDENTIAL. INTERNAL USE ONLY. 



VTOC EarPRY 



(types "vtoceJidr_t" and "vtoce" in vol. ins. pas) 
31 24 23 16 15 8 7 



+00 
+04 



VERSION I SYS_TyPE | UCCPIF- 



OBJECT 
UID 



UK) OF TYPE DEFINITION OBJECT 
FOR THIS OBJECT 



UK) OF ACL OBJECT 
FOR THIS OBJECT 



CURRENT LENGTH (BYTES) 



+20 I 



+24 I 



+28 I 



+2C i 



+34 I 
/ 



+BC I 



-k:o I 



+C4 I 



+C8 I 
+CC +- 



BLOCKS USED FOR FILE 



DATE-TIME LAST USED 



DATE-TIME LAST MODIFIED 



UK) OF DIRECTORY 
WHERE OBJECT IS CATALOGUED 



(end of vtoce_hdr_t) 



FILE MAP[0] 



FILE MAP [31] 



FILE MAP2[1] 



FILE MAP2[2] 



FILE MAP2[3] 



.version, 

.spys_type 
•uid 



.type_uid 

.elcljuid 

.cur_J.en 

.blocks_used 

.dtu 

.dtm 

.dirjiid 

.bbad2 



I 



U - VTOC entry in use (.inuse) 

CC - Concurrency control (.con_ctrl): 

00 None 

01 Shared 

10 Exclusive 
P - Permanent ( .biDermanent) 
I - Immutable (.immutable) 
F - File repaired by salvager (.trouble) 
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vnpc fgAp E y 

(type "vtoc_hdr_t" in vol. ins. pas) 

31 16 15 
+4C 



+50 
+54 
+58 
+5C 
+60 
+64 



VERSION NUMBER |# BLKS FOR HASH 

^ 



NUMBER VTOC BLOCKS USED 



VroCX OF NETWORK ROOT 



VTOCX OF ROOT DIR OF THIS VOLUME 



VTOCX OF PAGING FILE FOR AEGIS 



VTOCX OF BOOT FILE 



VTOC MAP 
(8 VTOC MAP ENTRIES) 



.version, 

.vtoc_size 
.vtocjDlocks 

.net_root 

.root_dir 

.os_x 

.boot_jc 

.nap 



.pad 



VTOC header lines in logical volume label. Offsets given 
are from start of label. 



VTQCMAP ENI^Y 

(type "vtocjnape" in vol. ins. pas) 
15 



+- 



+00 |# OONSEC. BLOCKS I .ItjDlk 



+- 



-+ 



+02 I DISK ADDRESS | .blk_add 
+ + 

I OF FIRST EXTENTI 



File System 
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VTOC INMX 

(type "vtcx:x_t'' in base. ins. pas) 
31 4 3 

H 1 + 

lODADDR OF VTOC BLK OF OBJECT ilNDX I (local object) 

H +_. — + 

-or- 
20 



I (remote object) 



IVQLXl (local, but DADDR 
-H + is unknown) 



INDX - Index of VTOC entry in VTOC block (0-4) 

or File Map index (0-7) 
VQLX - Logical volume number 
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CHAPTER 6 
PERIPHERAL I/O 



DEVICg APP PE S igE S (PIO ) 



DEVICE 




VIRTUAL 


PHYSICAL VIRTUAL 


PHYS] 






DN4xx and DN600 


DN300 


Multibus (64 pages) 


FEOOOO 


10000 






Line printer ctl 


FEFCOO 


IFCOO 






Multibus int ctl 


FEFC80 


1PC80 






MCSRs 




FF9000 


FCOO 


FFB404 


8004 


Display 2 c»ntrol 


FF9400 


FOOO 






Display 1 control 


FF9800 


F400 


FF9800 


9400 


Color control 


store 


FF 


E800 






Color user page 




E400 






Color super page 




EOOO 






PEB 




FF7000 


BOOO 






Ring 2 




FF9C00 


BCOO 


FF9C00 


9800 


Ring 1 




FFAOOO 


B800 






Floppy controller 


FFA800 


8C00 


FFA800 


9C00 


Timers 




FFACOO 


8800 






SIO lines 




FFBOOO 


8400 


FFBOOO 


8400 


MMU 




FFB400 


8000 


FFB400 


8000 


Page frame table 


FFB800 


4000 






DISK PAR;\METER£ 














CYI^ 


HEADS J 


BLK/TRK 


TOT BLKS 




33MB 


561 


3 


18 


30294 (7656) 




66MB 


1121 


3 


18 


60534 (EC76) 




154MB 


1121 


7 


18 141246 (227BE) 




300MB 


823 


19 


18 281466 (44B7A) 




8" PRIAM 3450 


525 


5 


12 


31500 (7B0C) 




8" PRIAM 7050 


1049 


5 


12 


62940 (F5DC) 




8" MICRDPOLIS 


580 


5 


13 


37700 (9344) 




FLOPPY 


77 


2 


8 


1232 (4D0) 
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SEC START SEC SIZE SEC DELTA ID 


33MB 
66MB 
154MB 


34 
34 
34 




1118 
1118 
1118 


3 1 
3 6 
3 7 


300MB 


34(?) 


1118 (?) 


9 — 


8" PRIAM 3450 
8" PRIM 7050 
8" MICRDPOLIS 




1120 
1120 
1181 


3(?) 104 
3(?) 5 
3{?) 1203 


FLOPPY 


146 




1202 


2 ~ 




T^to-^ S^E AVER. S^K MM S^L 


33MB 
66MB 
154MB 




8 msec 
8 msec 
8 msec 


45 msec 
45 msec 
45 msec 


85 msec 
85 msec 
75 msec 


300MB 










8" PRIAM 3450 
8" PRIAM 7050 
8" MICROPOLIS : 


8 msec 
8 msec 
L2 msec 


42 msec 
42 msec 
42 msec 


75 msec 
75 msec 
85 msec 


FLOPPY 














EPM 


AVER. LAT TRANSFER RATE 


33MB 
66MB 
154MB 




3100 
3100 
3100 


9.7 msec 
9.7 msec 
9.7 msec 


1.04 MBS 
1.04 MBS 
1.04 MBS 


300MB 










8" PRIAM 3450 
8" MICROPOLIS 


3600 
3600 


8.3 msec 
8.3 msec 


0.8 MBS 
0.92 MBS 



Perijiieral I/O 
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AVERAGE READ 



33MB 


45+9,7+1.0 = 55.7 




66MB 


45+9.7+1.0 = 55. 


.7 




154MB 


45+9.7+1.0 = 55. 


.7 




300MB 








8" PRIAM 3450 


42+8.3+1.3 = 51. 


.6 




8" MICROPOLIS 


42+8,3+1.1 = 51. 


.4 




FLOPPY 














DIAG DADDR 


33MB 


7620 (cyl 560) 




75AE (cyl 559) 


66MB 


EC40 (cyl 1120) 




ECOA (cyl 1119) 


154MB 


22740 (cyl 1120) 




226C2 (cyl 1119) 


300MB 


448CE (cyl 821) 




44A24 (cyl 822) 


8" PRIAM 3450 


7AD0 (cyl 524) 




7A94 (cyl 523) 


8" PRIAM 7050 


F5A0 (cyl 1048) 




F564 (cyl 1047) 


8" MICROPOLIS 


9303 (cyl 579) 




92C2 (cyl 578) 


FLOPPy 


4C0 (cyl 76) 
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DMAC page at [ 9000 | OFFAOOO ] 

DMA controller is a Motorola M68450. 

9000-903F - ring receive header 
9040-907F - ring receive data 
9080-90BF - ring transmit 
9000-90FF - Winchester/floppy 

Register suimtary (for each channel) : 

+00 Channel status register (CSR) 10? 

+01 Channel error register (CER) R 

+04 Device control register (DCR) R/W 

+05 Operation control register (OCR) IVW 

+06 Sequence control register (SCR) R/W 

+07 Channel control register (CCR) R/W 

+0A Memory transfer counter (MTC) R/W 

+0C Memory address register (MAR) R/W 

+14 Device address register (not used) 

+1A Base transfer counter (BTC) 

+1C Base address register (BAR) 

+25 Normal interrupt vector (not used) 

+27 Error interrupt vector (not used) 

+29 Memory function code register (MFCR) 

+2D Channel priority register (CPR) 

+31 Device function code register (not used) 

+39 Base function code register (BFCR) B/\/J 

+FF General Control Register (not used) 



R/W 
R/W 



R/W 
R/W 



CHANNEL STATUS REGISTE3^ (CSR) I 9000 I OFFAOOO 1 



|COC|BTC|NDT|ERR|ACT| |PTC|PCS| 



I I 
I I 
I 



I I 

I State of input PCL line 
I 1 => PCL transition occurred (*) 
I 1 => Channel active 
1 => Error as coded in CER (**) 
1 => Normal Device termination (*) 
1 => Block transfer c»mplete and continue (*) 
=> Channel operation complete (*) 



(*) Bit cleared by writing a 1 bit to CSR. 
{**) Ditto, and clearing also clears CER. 



Peripheral I/O 
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CHANNEL ERROR REGISTER fCERV I 9001 

76543210 
H H H H + 

lOlOlOlERROR CODEl 



OFFAQO X 



4- 



-+- 



-+- 



-+ 



00 - No error 

01 - Configuration error 

02 - Operation timing error 

03 - (undefined, reserved) 

05 - Address error: memory address or memory counter 

06 - Address error: device address 

07 - Address error: base address or base counter 

09 - Bus error: memory address or memory counter 
OA - Bus error: device address 

OB - Bus error: base address or base counter 

OD - Count error: memory address or memory counter 

OE - Count error: device address 

OF - Count error: base address or base counter 

10 - External abort 

11 - Software abort 



DEVICE CONTROL REGISTER (DCRV I 9004 I 0FFA004 1 
76543210 

H H H H 1 + 

(=28) 



I XRM I DTYP IDPSI 



PCL 



+- 



-+- 



-f- 



-+ 



- PCL = Status input 



1 - 16-bit port 
1 - Device with ACK, implicitly addressed 
- Burst mode transfers 
OPERATION CONTROL REGISTER fOCRV f 9005 I OFFA005 1 

76543210 
IDIRI I SIZE i CHAIN I REQG | (=92) 



REQ line initiates xfer 



- Chain operation disabled 
■ Word transfers 



- Transfer from memory to device 

1 - Transfer from device to memory 
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SECUENCE OOWrROL REGISTER (SCR) I 9006 I QFFA006 1 

76543210 
^ ^ H ^ ^ ^ + 

I I I I I mm: I DAC I (=04) 



-+- 



I I 
I I 



I 



N/A (Device address reg) 



1 - Menory address reg counts up 
CHANNEL OCMTROL REGISTER ICCR) I 9007 I OFFA007 1 
76543210 



-+- 



-+- 



-+- 



--f- 



ISTRlCNTiHLTlSABlIOTl 



I 



-\- 



-+ 



I 



I 1 => Enable interrupts 

I 

1 => Software abort 

1 => Halt operation 

1 => Continue opration 

1 => Start operation 

MEMORY TRANSFER COUNTS (MTC) f 900A-900B 1 0FFA00A-0FFA00B1 



WORDCOUNT I 



(E.g., 512 to transfer a page.) 
mmRY ADDRESS REGISTER (MftR) f 900C-900F I OFFAOOC-OFFAOOFI 



I HIGH I UP-MID I LO-MID 



9018 901A 901C 901E 
Load with lOVEP.L A0,9018. 

DEVICE AmRESS REGISTER (PAR) [9014-9017 1 0FFA014-0FFA0171 
Not used. 

EA SE TRANSFER COUNTER (BTQ [ 9 Q 1A-901B | O FFA OlA-OFFAQl Bl 
Same as Monory Transfer Counter. 



Peri0ieral I/O 
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BASE AmRESS REGISTER fBRR) r901C-901F I OFFAOIC-OFFAOIF 1 

Same as Memory Address Register. 

NORMAL IMFERRUPT VECTOR REGISTER f 9025 I 0FFA025 1 

Not used. 

EmM INTEa^lUPT VECTOR REGIgTEJ^ [ 9 Q 27 I 0FFA027 1 

Not used. 

MEMORY FUNCTION CX^E RgGIgTER (MFCR) [ 9Q29 I OFFA029 1 



|0|010I0|0|F|F|F| 

[ I I 

- ring transmit data 

1 - ring transmit header 

Function code not used on other channels. 

CHANNEL PRIORITY REGISTER (CPR) T 902D I 0FFA02D 1 



|0|010|0|0|0IP|P| 
H ^ ^ ^ — _H ^ ^ ^ + 



I I 
Channel 0: - ring receive header 

(highest) 
Qiannel 1: 1 - ring receive data 
Channel 2: 1 - ring transmit 
Channel 3: 1 1 - winchester/f loppy 

(lowest) 

DEVICE FUNCTION CODE REGISTER (DFCR) I 9031 I 0FFA031 
Not used. 

BA SE FUNCTION COPE REGISTER (BFCR ) [ 9 39 I QFFA039 1 

Not used. 
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pyQoo 



Address: [ 9C00 1 OFFA800 ] 





WRITE 


READ 


+00 


ANSI COMMAND | 


! ATTENTION STATUS 1 


+02 


ANSI FARM OUT | 


1 ANSI PARM IN 1 


+04 




1 DRIVE # OF STATUS | 


+06 


SECIDR 1 


1 CONTROLLER STAT^HIl 


+07 




1 CONTROLLER STAa^DOl 


+08 


CYLINDER-HI | 




+09 


CYLINDER-ID | 




+0A 


HEAD 1 




+0C 


INTERRUPT CONTROL 1 




+0E 


CONTROLLER CMND | 




+10 




1 FLOPPY STATUS | 


+12 


FLOPPY WRITE DATA | 


1 FLOPPY READ DATA | 


+14 


FLOPPY CONTROL | 




+20 


CALENDAR CONTROL 1 




+22 


CALENDAR WRITE DATA| 




+24 




1 CALENDAR READ DATA I 



mNTpOTTCT cfTATTTS [ 9C06 I 0FFA806 ] 



8000 15 Controller busy 

4000 14 Drive busy (from bus) 

2000 13 Drive attention (from bus) 

1000 12 Status available interrupt 

0800 11 End of operation interrupt 

0400 10 Floppy interrupting 



0080 


07 


Timeout 


0040 


06 


Overrun 


0020 


05 


CRC error 


0010 


04 


Controller bus parity error 


0008 


03 


Illegal configuration 


0004 


02 


Status timeout 



0002 01 Parity error during EMA 



Reset by 
Self clearing 
Self clearing 
Cntr, if status 

avail enab 
Read attn status reg 
Write to ctlr cmd reg 
Read f loj^jy status reg 

Write to ctlr cmd reg 
Write to ctlr cmd reg 
Write to ctlr cmd reg 
Write to ctlr cmd reg 
Write to ctlr cmd reg 
Read attention status 

reg 
Write to controller 
command reg 
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AKBI COMMANDS [ 9000 | 0PFA800 ] 



PARAMETER OUT COMMANDS 
40 Attention control 



Parameter 

Bit 7 = => enable attention 
1 => disable attention 



41 


Write c»ntrol 


Bit 7 = => write protect 
1 => write enable 


42 


Load Cyl. Addr. high 


MSB of cylinder address 


43 


Load Cyl. Addr. low 


I£B of cylinder address 


44 


Select head 


Head number Mandatory 


50 


Load attribute number 


Attribute number Optional 


51 


Load attribute 


Attribute 


53 


Read control 


Bits 7,6 = Ox - nominal strobe 

10 - strobe early 

11 - strobe late 


54 


Offset control 


Bits 7,6 = Ox - no offset 

10 - offset forward 

11 - offset reverse 


55 


Spin control 


Bit 7=0- spin down 
1 - spin up 


56 


Load sect/trk high 


MSB of sectors/track 


57 


Load sect/trk medium 


MedSB of sectors/track 


58 


Load sect/trk low 


I£B of sectors/track 


59 


Load bytes/sect high 


MSB of bytes/sector 


5A 


Load bytes/sect medium 


MedSB of bytes/sector 


5B 


Load bytes/sect low 


ISB of bytes/sector 


6B 


Load read permit high 


MSB of read enable on cyl >= 


6C 


Load read permit low 


I5B of read enable cyl 


6D 


Load write permit high 


MSB of write enable on cyl >= 


6E 


Load write permit low 


I£B of write enable cyl 


6F 


Load test byte 


Test byte 
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PARAMETER IN CDMMANDS 

00 Report illegal cx)iratHnd General status 



01 


Clear fault 


General status 


02 


Clear attention 


General status 


03 


Seek * 


General status 


04 


Rezero * 


General status 


OD 


Report sense byte 2 


Sense byte 2 


OE 


Report sense byte 1 


Sense byte 1 


OF 


Report general status 


General status Mandatory 


10 


Report drive attribute 


Drive attribute Optional 


11 


Set attention * 


General status 


14 


Selective reset * 


General status 


15 


Seek to landing zone * 


General status 


16 


Reformat track * 


General status 


29 


Report cyl. addr. high 


MSB of cylinder address 


2A 


Report cyl. addr. low 


I£B of cylinder address 


2B 


Report read permit high 


MSB of cylinder address 


2C 


Report read permit high 


LSB of cylinder address 


2D 


Report wrt permit high 


MSB of cylinder address 


2E 


Report wrt permit high 


LSB of cylinder address 


2F 


Report test byte 


Test byte 


* 


Time dependent command. 


attention set on completion. 


AITEI^ION STATUS [ 9000 | 


0FFA800 ] 






Clearea by 


7 


80 Normal completion * 


Clear attention comaonand 


6 


40 Busy 


Self clearing 


5 


20 Read sense byte 2 


See sense byte 2 


4 


10 Read sense byte 1 


See sense byte 1 


3 


08 Illegal parameter * 


Clear fault command 


2 


04 Illegal command * 


Clear fault command 


1 


02 Control bus error * 


Clear fault command 





01 Not ready 


Self clearing 



Zero to one transition sets attention. 



Vendor unique errors 
Other errors 
Command reject 
Speed error 
RA' permit violation 
Power fault 
Read/write fault 
Seek error 



mand/opt 



M 



M 
M 
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SENSE BYTE 1 itand/opt 

7 80 Vendor unique attns * 

6 40 In write-protected area M 

5 20 Attr. table modified * 

4 10 Dev rsrved to alt port 

3 08 Forced release * 

2 04 Dev rsrved to this port 

1 02 Ready transition * M 

01 Initial state * M 

* Zero to one transition sets attention, 

INTEPRUPT qONTRQL [ 9C0C | 0FFA80C ] 



I7|6|5|4|3|2|l|0| 
H H H ^ ^ H 1 H + 

III! 

I I I Enable End of Op int 
I I Enable Status Avail int 
I Enable Attention int 
Overall interrupt enable 

mNTPRnr.r.RR OOMMAM>S [ 9C0E | 0FFA80E } 

00 - No-op 

01 - Read record 

02 - Write record 

03 - Format track 

04 - Seek 

05 - Execute ANSI command sequence 

06 - Execute drive select sequence 

07 - Execute attention in sequence 

08 - Select head 

Any command clears the controller status register. 
FjJOPPY (XftmOh [ 9C14 I 0FFA814 ] 



I 1110 



I - Read 

I 1 - Write 

I 

1 => Enable floppy interrupt 
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pm xx and vm oo 

Floppy status [ 8C00 | FFA800 ] 
Floppy I/O [ 8C00 | FFA800 ] 
Floppy DMA [ 8C80 I FFA880 ] 

Floppy Status Registers 

Main Status Register 

I D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO I 

D7 - {R(^} Data register rea^ to send/receive data from 

Processor . 
D6 - {DIO} I/O Direction, 1 = Data Reg to Processor, = 

Processor to Data Reg. 
D5 - {Em} Execution mode for non-DMA transfers 
D4 - {CB} BUSY, a Read or Write COTmand is in process 
D3 - {D3B} FDD 3 is in Seek Mode 
D2 - {D2B} FDD 2 is in Seek Mode 
Dl - {DIB} FED 1 is in Seek Mode 
DO - {DOB} FDD is in Seek Mode 

STATUS REGISTER 



D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO I 



D7 - D6 
Normal Termination of Command 

1 Abnormal Term {command started, not completed} 

1 Invalid Command { command issued never started } 
1 1 Abnormal Termination { FED went not ready during 

command execution } 
D5 - Set v^en Seek Completed 
D4 - Set if FDD issues Fault Signal or Track Signal 

fails to occur after 77 Step Pulses. 
D3 - Set if FDD Not Ready 
D2 - Head Address 
Dl - Unit Select 1 Status 
DO - Unit Select Status 

STATUS REGISTER 1 

I D7 i D6 I D5 I D4 I D3 I D2 I Dl I DO I 

D7 - End of Cylinder 

D6 - 

D5 - Data Error 

D4 - Overrun 

D3 - 

D2 - No Data 

Dl - Not Writable 

DO - Missing Address Mark 
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STATUS REiGISTER 2 



I D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO I 

D7 - 

D6 - Control Mark 

D5 - Data Error in Data Field 

D4 - Wrong Cylinder 

D3 - Scan Equal Hit 

D2 - Scan NOT Satisfied 

Dl - Bad Cylinder 

DO - Missing Address Mark in Address Field 

STATUS REGISTER 3 

I D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO I 

D7 - Fault from FDD 

D6 - Write Protected 

D5 - Ready from FDD 

D4 - Track 

D3 - TVo Side 

D2 - Head Address 

Dl - Unit Select 1 Status 

DO - Unit Select Status 
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I/O MAP 



16-bit address 
from controller: 



0-2 bits "strapped" 
per c»ntr oiler: 



18-bit virtual 
EMA address: 



+{{- 



-}}+ 



I I I 

-+ 

I 

I 

17 V 10 9 V 

^ — H 



I 
+{{- 



-}}+{{- 



-}}+ 



+00 



//I 



12-bit PPN 



lOHDit page 

displacement 



22-bit physical +- 
address : I 



+{{- 



— > Byte 
Select 



lOMAP has 256 one-ivord entries from FFF800 - FFF9FE. 
FFFAOO-FFFCOO reserved for future expansion (lOMAP 2) . 



Peripheral I/O 



6-14 /\POLLO CONFIDENTIAL. IIMTERIMAL USE ONLY. 



I /Q MftP A hK)CATION 



DEVICE 


10 PAGES 


IQMAP m^ APK^SES 


Floppy 


0-1 


FFF800-FFF802 


( 2 pages) 


Unused 


2-3F 


FFF804-FFF87E 


(62 pages) 


Winchester 


40-41 


FFF880-FPP882 


( 2 pages) 


Ring Transmit 


42-45 


FFF884-FFF88A 


( 4 pages) 


Ring Receive 


46-49 


FFF88C-FFF892 


( 4 pages) 


Ring 2nd Rev Oian 4A-4D 


FPP894-PFF89A 


( 4 pages) 


Unused 


4E-5E 


PFF89C-PPF8BC 


(17 pages) 


Color DMA 


5F-7F 


FPF8BE-FPP8PE 


(33 pages) 


Bit blit 


80-9F 


FFF900-FFF93E 


(32 pages) 


Unused 


AO-BF 


FFF940-FFP97E 


(32 pages) 


Multibus 


CO-PP 


FPF980-PPP9PE 


(64 pages) 
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F1 


F2 


F3 


F4 


F5 


F6 


F7 


F8 






















BACK 
SPACE 


TAB 


















RETURN 










R1 






1 CTRL 


SPACE 











u 


R3 


R4 


- 



ftpollp I j^eyty^ard - Map 



A pollo I K eyboard Qiart - Physical 



Apollo 

4 5 



I Keyboard Chart - 
6 7 8 9 



- 


"P 


BUJK 





@ 


P 




P 


Rl 


NO 


RIU 


NOU 


Fl 


,. 


Flu 


FlC 


'A 


-Q 


! 


1 


A 


Q 


a 


q 


LI 


Nl 


LIU 


NIU 


F2 


F2S 


F20 


F2C 


^ 


-R 




2 


B 


R 


b 


r 


L2 


N2 


L2U 


N2U 


F3 


F3S 


F3U 


F3C 


"C 


S 


# 


3 


C 


S 


c 


3 


L3 


N3 


L3U 


N3U 


F4 


F4S 


F4U 


F4C 


"D 


"T 


$ 


4 


D 


T 


d 


t 


L4 


N4 


L40 


N4U 


F5 


F5S 


F5U 


F5C 


^E 


"U 


* 


5 


E 


U 


e 


" 


L5 


N5 


L5U 


N5U 


F6 


F6S 


F6U 


F6C 


"F 


"V 




6 


F 


V 


f 


V 


L6 


N6 


L6U 


N6U 


F7 


F7S 


F7U 


FTC 


"G 


"W 




V 


G 


w 


g 


w 


L7 


N7 


L7U 


N7U 


F8 


F8S 


F8U 


F8C 


-H 


^ 




8 


H 


X 


h 


X 


LB 


N8 


L8Q 


N8U 


\ 


\s 


tpad 


"\ 


-I 


~Y 




9 


I 


Y 


i 


y 


L9 


N9 


L9U 


N9U 


1 


IS 




IC 


'J 


"Z 






J 


Z 


j 


^ 


LA 


N. 


LAU 


N.U 


TAB 


TABS 




TABC 


"K 


"[ 




; 


K 


{ 


^ 


[ 


LB 


N= 


LBU 


N=U 


CR 


CRS 




CRC 


"L 






< 


L 




1 




LC 


N+ 


LCU 


N+U 


/ 


? 




V 


"M 


"] 


- 


= 


M 


} 


. 


] 


LD 


N- 


LDU 


N-U 


R2 


R5 


R2U 


R5U 


"N 


- 




> 


N 




n 




LE 


N* 


LEU 


N*U 


R3 


BS 


R3U 




"0 











- 


° 




LF 


N/ 


LFU 


NAl 


R4 




R4U 
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PipollQ J Keyboard Chart - Translated (user mode) 



/^llo I Keyboard Chart ■ 
4 5 6 7 8 3 



Translated (user mode) 
A B C D E 





"P 


SP 





@ 


P 




P 




Rl 




RIU 


Fl 


F]S 


FIO 


FlC 


"A 


"Q 




1 


A 


Q 


a 


q 


LI 


R2 


LIU 


R2U 


F2 


F2S 


F2U 


F2C 


~B 


"R 




2 


B 


R 


b 


^ 


L2 


R3 


L2U 


R3U 


F3 


F3S 


F3U 


F3C 


"C 


"S 




3 


C 


S 


c 


3 


L3 


R4 


L3U 


R40 


F4 


F4S 


F4U 


F4C 


'D 


"T 




4 





T 


d 


t 


L4 


R5 


L40 


R5U 


F5 


F5S 


F5U 


F5C 


"E 


U 




5 


E 


U 




U 


L5 


BS 


L50 




F6 


F6S 


P6U 


F6C 


"F 


"V 




6 


F 


' 




V 


L6 


CR 


L6U 




F7 


F-K 


F70 


FX 


"G 


"W 




7 


G 


W 




w 


L7 


TAB 


L7U 




F8 


Fas 


F8U 


FSC 


^H 


-X 




8 


H 


X 




X 


L8 


STAB 


L8U 




NO 


N8 


NdJ 


N8U 


'I 


•^ 




3 


I 


Y 




Y 


L9 


CTAB 


L30 




Nl 


m 


NIO 


N9U 


"J 


"z 






J 


Z 




^ 


LA 




LAD 




N2 


N. 


N2U 


N.U 


-K 


*[ 




■' 


K 


[ 




{ 


LB 




LBU 




N3 


N= 


N3U 


N=<J 


"L 


- 






L 


\ 




1 


IC 




LCU 




N4 


N+ 


N4U 


N+U 


"M 


^] 




= 


« 


] 


„ 


} 


LD 




LDC 




N5 


N- 


N5U 


N-U 


-N 






> 


N 


" 


" 




LE 




LEU 




N6 


N* 


N6U 


N*U 


■'o 


V 




? 





- 


° 


^1 


LF 




LETJ 




N7 


N/ 


N7U 


NAI 



9 A B C D 



Peri0ieral I/O 
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LI 


L2 


L3 




L1A 


- 


- 




L4 


L5 


L6 




L^ 


L8 


L9 








LA 


LB 


LC 




LD 


-^ 


- 



F1 


F2 


F3 


F4 




FS 


F6 


- 


F8 



R2 R4 R5 I R6 



Apollo II Keyboard - Map 



APPllo II Keyboard Chart - Physical 



Hign Order Nibble 



i^llo II Keyboard Chart - 
4 5 6 7 8 9 



Physical 
ABC 



D E F 



"SP 


'P 


SP 





@ 


P 




p 


Rl 


RIS 


RIU 


L]A 


Fl 


FIS 


FlU 


FlC 


"A 


'Q 




1 


A 


Q 


- 


q 


LI 


LIS 


LIU 


L2A 


F2 


F2S 


F2U 


F2C 


"B 


''R 




2 


B 


R 


b 


^ 


L2 


L2S 


L2U 


L3A 


F3 


F3S 


F3U 


PX 


"C 


"S 




3 


C 


S 


c 


^ 


L3 


L3S 


L30 


R6 


F4 


F4S 


F4U 


F4C 


^- 


"T 




^ 


- 


T 


d 




M 


L4S 


L4U 


LIAS 


F5 


F5S 


F5U 


F5C 


"E 


^ 




5 


E 


U 


e 


" 


L5 


L5S 


L5U 


L2AS 


F6 


F6S 


F6U 


P6C 


•^F 


"V 


& 


6 


F 


V 


^ 


V 


L6 


L6S 


L6U 


L3AS 


n 


P-S 


F7a 


,x 


"G 


"W 




7 


G 


w 


g 


w 


L7 


L-ffi 


L7U 


R6S 


F8 


Fas 


FSJ 


,<c 


"H 


^ 




8 


H 


X 


h 




L8 


L8S 


LSO 


LlAU 


\ 




tpad 


"V 


"I 


~Y 




9 


I 


Y 




y 


L9 


L9E 


L9U 


L2AU 


1 




R2S 




^J 


'Z 




= 


J 


Z 




^ 


LA 


LAS 


LAU 


L3AU 


TAB 


TABS 


R3S 


TABC 


^- 


ESC 






K 


{ 




, 


IB 


LBS 


IBU 


R6U 


CR 


CRS 


R4S 


CRC 


"L 






< 


L 




^ 




LC 


LCS 


LCU 




/ 




R5S 


V 


"M 


"] 




= 


M 


} 


. 


] 


LD 


LDS 


LDO 




R2 


R5 


R2U 


R5U 


"N 






> 


N 








LE 


- 


LEU 




R3 


as 


R3U 




"0 











- 


° 


DEL 


LF 


LFS 


LFO 




R4 


mous 


R4U 





7 8 9 A B C D 



Peri0ieral I/O 
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Apollo II Keyboard C hart - Translated (user mode) 



Apollo II Keyboard Chart - translated (u£ 
456789ABC 



D E 



~SP 


-P 


SP 





@ 


P 




P 




Rl 




RIU 


Fl 


PB 


Flu 


FlC 


^A 


^Q 


' 




"" 


Q 


a 


q 


LI 


R2 


"" 


R2U 


F2 


F2S 


F2U 


F2C 


^ 


~R 


^ 




B 


R 


b 


r 


L2 


R3 


L2U 


R3U 


F3 


F3S 


F3U 


F3C 


"C 


^S 


. 




C 


S 


c 


3 


L3 


R4 


L3U 


R4D 


F4 


F4S 


F4U 


F4C 


-D 


"T 


$ 




- 


T 


d 


t 


L4 


R5' 


L40 


R5U 


F5 


F5S 


™ 


F5C 


"^E 


~U 


% 




E 




e 


^ 


L5 


BS 


L5U 


R2S 


F6 


F6S 


F6U 


F6C 


~F 


-V 


& 


6 


F 


^ 


f 




L6 


CR 


L6U 


R3S 


F7 


F7S 


F7U 


FTC 


-G 


-v 




7 


G 


W 


g 


w 


L7 


TAB 


LTQ 


R4S 


F8 


F8S 


FSJ 


Fac 


"H 


-X 


( 


3 


H 


X 


h 


X 


L8 


STAB 


L8U 


R5S 


RIS 


L8S 


LIA 


LIAU 


^I 


"^Y 


) 


3 


I 


y 


i 


y 


L9 


CTAB 


L3U 




LIS 


Las 


L2A 


L2AU 


~J 


'Z 






J 


z 


J 


^ 


LA 




LAU 




L2S 


LAS 


L3ft 


L3AU 


"K 


ESC 


- 


; 


K 


[ 


k 


{ 


LB 




LBU 




L3S 


IBS 


R6 


R6U 


"L 


A 




< 


L 


\ 


1 


1 


LC 




LCU 




L4S 


LCS 


LIAS 




H 


"] 




= 


M 


1 


m 


} 


LD 




LDU 




L5S 


IDS 


L2AS 




~N 








N 




n 




LE 




LEO 




L6S 


LES 


L3AS 




~0 


/' 


/ 


? 





- 


° 


DEL 


LF 




LFU 




L7S 


LFS 


H6S 
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MAGTAPE CY)rTrpr)T(TiF?R 



Controller control page: FE8000 
Interrupt vector number: B3 ($2CX:: in page 0) 
Multibus interrupt level: 3 (See MIC) 
lOMAP entries: FFF980-FFF9FE (64 pages) 



FE80M 
FE80AB 



CHANNEL ATTENTION (do something useful) 
CONTROLLER RESET 



Sygtem Cpnf igyratipn fpinter (at xxxff^) 

+00 +01 +02 +04 



-+- 



-+- 



1 00000001 1 00000000 1 -> CONFIG BLOCK 



iSystem Configuration Block 

+00 +01 +02 



1 00000011 1 00000000 1 ->CHAN CONFIG ELK I 



Channel Control Block 





15 8 7 


+00 


CCW I GATE 1 


+02 


-> FARM BLOCK | 


+04 


1 


+06 


1 



CCW: Set to $11 for normal 
operations. Set to $09 to 
clear active interrupt. 

GATE: Set to $FF before starting 
an operation. Set to 00 by 
controller on completion. 



'To initiate an operation 

(Set up parameter block) 

MDVE.W #$11FF,GATE 
MDVE.B #0r$FE80AA 



CLOSE GATE 

WAKE UP GOOTRQLLER 



Peri^ieral I/O 
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To acknowledge tape interrupt ! 

MOVE.W #$09FF,GATE CLOSE GATE 

MOVE.B #$20,CMD_EKTE D0-N3THING COMMAND 

MOVE.W NO_I_BIT, CONTROL ENSURE XNTEFHJPT BIT OFF 

MOVE.B #00,$FE80AA WME UP CONTROLLER 

TST.B GATE+1 WAIT FOR ACK TO FINISH 

BNE *-4 



Parameter bxc 


15 


(CONTROL - 
(STAIUS — 




+00 


CMD BYTE 100000000 




+02 







+04 


WG-SHR— IDLIMUU— 


- SEE BELCW) 


+06 


ACTUAL COUMT 




+08 


COUOT TO R/W (*) 




+0A 


RECORDS/OVERRUN 




+0C 


BUFFER POINTER 




+0E 







+10 


SC-EEEEEI-OLERBP- 


- SEE BELOW) 


+12 


lOT OR LINK PTR 




+14 








* Manufacturer recommends 4K 
COMMAND BYTE 



00 


Initialize 


3C 


Edit (rewrite prior record) 


20 


No operation 


40 


Write filemark 


28 


Return status 


44 


Skip to filemark 


2C 


Read 


48 


Space 'n' records 


30 


Write 


70 


Space 'n' or to filemark 


34 


Rewind 


4C 


Erase fixed (3.5" * 'n') 


38 


Rewind/unload 


50 


Erase from here to EOT 
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CONTROL WORD (appropriate value) 

W 8000 Bus width (0 => 8 bits^ 1 => 16) (1) 

G 4000 Grab bus before tape movement (0) 

S 1000 Operate in streaming mode (?) 

H 0800 Select high speed (lOOips) (0) 

R 0400 Reverse direction for operation (?) 

D 0080 Grab bus during EMA transfers (0) 

L 0040 Link (=> ignore I and M bits) (?) 

I 0020 Interrupt when done (1) 

M 0010 1 => use mailbox interrupts (0) 

UU OOOC Unit select (00 through 11) (00) 

STATUS WORD (normal state at conpletion) 

S 8000 Execution (of parm block) started (1) 
C 4000 Execution completed ok (1) 

E..E iFOa Error code: (00) 

00 No unrecoverable error 

01 Timed out waiting for Data Busy false 

02 Timed out waiting for Data Busy false. 
Formatter Busy false and Rea^ true 

03 Timed out waiting for Ready false 

04 Timed out waiting for Read/ true 

05 Timed out waiting for Data Busy true 

06 Memory time-out during syston manory reference 

07 Blank tape encountered 

08 Error in micro-diagnostic 

09 Unexpected end of tape 
OA Tape read/write error 
OB Tape overrun 

OD Read parity error 
OE Checksum error 

OF Tape timeout (read on blank tape or 
reading larger block than written) 

10 Tape not ready 

11 Write attempted on protected tape 

13 Diagnostic mode jumper not installed 

14 Illegal attempt to link 

15 Filenark encountered during read operation 

16 Parameter error (byte count zero or too large) 

18 Hardware error 

19 Read or write terminated by OS or disk 

0040 Online (1) 

L 0020 Load point (?) 

E 0010 End of tape (?) 

R 0008 Ready (1) 

B 0004 Formatter busy (0) 

P 0002 Tape is write protected (?) 



Peri0ieral I/O 6-24 apollocxjnrdential. internal use only. 



MULTIRJS PE VICg A DK^SPS 



Multibus (64 pages) 
line printer ctl 
Multibus int ctl 



VIRTUAL PHYSICAL 

FEOOOO 10000 

FEPCOO IPCOO 

FEPC80 1PC80 



[ BOOO I FF7000 ] 



CACHE Pages: 


[ C400 1 FF7C00 ] 




[ C800 1 FF8000 ] 






peb_ctrl 


FF7000 


peb_status 


FF7000 


fpu_cnd 


FF7400 


fpu_3tatus 


FF77FC 


fpu^cs_sa 


FF7800 


fptL.cs_ea 


FF7C00 


wcs_J.k_^ize 


1024*8 


wcs_4k_size 


4096*8 


fpu_defalth 


00B2000E 


fpu_defaltl 


50007 9E3 


wcserr_vec 


Fl«2 


xcp_int vec 


2e0 


Id^fa 


l*4+fpu_cmd 


rd^a 


3*4+fpu_cnd 


IdjEah 


19*4+fpiL_cnd 


ld_fal 


20*4+fpu_cnid 


rdjEah 


23*4+fpu_cnd 


rd^al 


24*4+fpu and 


ld_jEth 


39*4+fpu_cmd 


dp_jnul 


40*4+fptL.cmd 


sp_div 


17*4+fpu cmd 


rdjexp 


55*4+fpu_cind 


ld_exp 


253*4+fpu_cird 


xcp_reg 


61*4+fpu_cmd 


cache_sa 


FF7C00 


cache_ea 


FF8400 


memory_sa 


120000 


inemory_ea 


120800 


tag_jLnval 


800 


tag_validJDit 


11 



peb cx)ntrol register 

peb status register (sys space) 

fpu command register 

fpu status register (user space) 

fpu control store sa 

fpu control store ea 

fpu control store bytes 

fpu control store in hsytes 

fpu default microword, high 32 

fpu default microword, low 32 

wcs error interrupt vector 

Fpu Exception Interrupt Vector 

load fa sp 

read fa sp 

load fah dp 

load fal dp 

read fah dp 

read fal dp 

load ftl dp 

load fth and start a dp multiply, 

to look at busy setting, clearing, 

reading 
load ftl sp div. 

read fam register as raw 32 bits 
loadfam register as raw 32 bits 

and do NA<=EXP 

load fam register as raw 32 bits 
cache window start 
cache window end 
memory start 
manory end 
invalid tag word 
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PEB Contrp l Re g ister Bits 



peb_f pu_en 

peb_jEpu_step 

peb_fpu_reset 

peb_fpu_jiie 

peb_fpu_csad 

peb_cache_a 

peb_cachejD 

peb_test_t 

peb_test_d 

peb_cache_tpe 

peb_cache_dpe 



0001 
0002 
0004 
0008 
OOIF 
0200 
0400 
0800 
1000 
2000 
4000 



fpu enable 

f pu step 

fpa reset 

fpu interrupt enable 

upper control store address bits 

cache A (0050) 

cache B (0051) 

test tag ram (0052) 

test data ram (0053) 

cache tag parity enable (0054) 

cache data parity enable (0056) 



Useful Combinations 



peb_cache_tta 

peb_cache_ttb 

peb_cache_tda 

peb_cache_tdb 

enab_tag_a 

enab_tagjD 

enab_data_a 

enab_data_b 

enab_cache_a 

enab_cache_b 

enab_cache 



peb_cache_a+peb_test_t (0060) test tag A 
peb_cachejD+peb_test_t (0061) test tag B 
peb_cache_a+peb_test_d (0062) test data A 
peb_cache_b4peb_test_d (0063) test data B 
peb_cache_tta+peb_cache_tpe+peb_cache_dpe ( 06 5 ) 
peb_cache_ttb+peb_cache_tpe+peb_cache_dpe ( 006 6 ) 
peb_cache_tda+peb_cache_dpe+peb_cache_tpe ( 0067 ) 
peb_cache_tdb4peb_cache_dpe+peb_cache_tpe ( 06 8 ) 
peb_cache_a+peb_cache_dpe+peb_cache_tpe ( 006 9 ) 
peb_cachej3+peb_cache_dpe+peb_cache_tpe ( 007 ) 
enab_cache_a+peb_cache Jd ( 007 1 ) 



PEB S tat us Re gister B j tig 



peb_fpu_cspe 

peb_cache_pe 

peb_fpu_xip 

peb_fpu_upc 

peb_fpujDUsy 

PEB Commands 



0001 
0002 
0004 
07FF 
8000 



control store parity error 

cache parity error 

fpu exception interrupt pending 

fpu program counter bits 

fpu busy 



(from f pp. ins. pas) 
FPP_$TSTX 



FPP_$SSTX 
FPP_$EXIT 

FPP_$SLV 
FPP_$SLA 

FPP_$SLC 

FPP_$SOTA 

FPP_$SAV 
FPP_$SAA 
FPP_$SAC 



Test S.P. or D.P. FAC for -,0,+; set cc's & DO.L 

then exit 
Same as FPP_$SSTA but exits when done (sets cc's) 
Return to caller beginning with instruction in next 

word 

FAC := (SP)+ (Single precision Load Value) 
FAC := ((SP)+) (Single precision Load using 

Address) 
FAC := Next four bytes in instruction stream 

(Constant) 
((SP)+) := FAC (Single precision STore using 

Addr) 



FAC 
FAC 
FAC 



= FAC + (SP)+ (Single precision Add Value) 

= FAC + ((SP)+) 

= FAC + Next four bytes (Constant) 



Peripheral I/O 
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FPP_$SSV 

FPP_$SSA 
FPP_$SSC 
FPP_$SISV 

FPP_$SISA 
FPP_$SISC 
FPP_$SMV 

PPP_$SMA 
FPP_$SMC 
FPP_$SDV 
FPP_$SDA 
FPP_$SDC 
FPP_$SIDV 

FPP_$SIDA 
FPP_$SIDC 
FPP_$SCVX 
FPP_$SCAX 
FPP_$SCCX 

FPP_$SLWV 

FPP_$SLWA 

FPP_$SLLV 

FPP_$SLLA 

FPP_$SSTWX 

FPP_$SSTLX 

FPP_$NEG 

FPP_$ABS 

FPP_$DLA 

FPP_$DLC 
FPP_$DSTA 

FPP_$DSTX 

FPP_$DAA 

FPP_$DAC 

FPP_$DSA 

FPP_$DSC 

PPP_$DISA 

FPP_$DISC 

FPP_$DMA 

FPP_$DMC 

FPP_$DDA 

FPP_$DDC 

FPP_$DIDA 

FPP_$DIDC 

FPP_$DCAX 

FPP_$DCCX 

FPP_$DLWV 



(Single precision Subtract 



FAC := FAC - (SP)+ 

Value) 
FAC := FAC - ((SP)+) 
FAC := FAC - Next four bytes (Constant) 
FAC := (SP)+ - FAC (Single precision Inverse 

Subtract Value) 
FAC := ((SP)+) - FAC 
FAC := Next four bytes (Constant) - FAC 
FAC := FAC * (SP)+ (Single precision Multiply 

Value) 

FAC := FAC * ((SP)+) 

FAC := FAC * Next four bytes (Constant) 
FAC := FAC / (SP)+ (Single precision Divide Value) 
FAC := FAC / ((SP)+) 

FAC := FAC / Next four bytes (Constant) 
FAC := (SP)+ / FAC (Single precision Inverse Divide 
Value) 
FAC := ((SP)+) / FAC 

FAC := Next four bytes (Constant) / FAC 
Compare FAC : (SP)+; set cc's & DO.L then exit 
Compare FAC : ((SP)+); set cc's & DO.L then exit 
Compare FAC : Next 4 bytes; set cc's & DO.L then 
exit 

(Float 16 bit integer) 
(Float 16 bit integer) 
(Float 32 bit integer) 
(Float 32 bit integer) 



FAC 
FAC 
FAC 
FAC 
DO.W 



= Float [(SP)+] 

= Float [((SP)+)] 

= Float [(SP)+] 

= Float [((SP)+)] 

:= Fix [FAC]; then Exit with cc's set 
DO.L := Fix [FAC]; then Exit with cc's set 
FAC := -FAC (Single or Double Precision) 
FAC := Abs[FAC] (Absolute value Single or Double 

Precision) 
D.P. FAC := ((SP)+) (Double precision Load using 
Address) 
D.P. FAC := Next 8 bytes (Constant) 
D.P. ((SP)+) := FAC (Double precision Store using 

Address) 
D.P. Same as FPP_$DSTA but exits v*ien done 

(sets cc's) 
D.P. FAC := FAC + ((SP)+) 
D.P. FAC := FAC + Next 8 bytes (Constant) 
D.P. FAC := FAC - ((SP)+) 
D.P. FAC := FAC - Next 8 bytes (Constant) 
D.P. FAC := ((SP)+) - FAC (Inverse Subtract) 
D.P. FAC := Next 8 bytes (Constant) - FAC 
D.P. FAC := FAC * ((SP)+) 
D.P. FAC := FAC * Next 8 bytes (Constant) 
D.P. FAC := FAC / ((SP)+) 
D.P. FAC := FAC / Next 8 bytes (Constant) 
D.P. FAC := ((SP)+) / FAC (Inverse Divide) 
D.P. FAC := Next 8 bytes (Constant) / FAC 
D.P. Compare FAC : ((SP)+); set cc's & DO.L then 

exit 
D.P. Compare FAC : Next 8 bytes; set cc's & DO.L 

then exit 
D.P. FAC := Float! (SP)+] (Float 16 bit integer) 
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FPP_$DLWA 

FPP_$DLLV 

FPP_$DLLA 

FPP_$DSTWX 

FPP_$DSTLX 

FPP_$SCNV 

FPP_$DCNV 

FPP_$SSQR 

FPP_$DSQR 

FPP_$SEXP 

FPP_$DEXP 

FPP_$SLOG 

FPP_$DLOG 

FPP_$SSIN 

FPP_$DSIN 

FPP_$SOOS 

FPP_$DCOS 

FPP_$OTAN 

FPP_$DTAN 

FPP_$SATAN 

FPP_$DATEN 

FPP_$SATAN2A 

FPP_$SATAN2V 

FPP_$SATAN2C 

FPP_$DATAN2A 

FPP_$nATAN2C 

FPP_$E$21V 

FPP_$E$22A 

FPP_$E$22V 

FPP_$E$22C 

FPP_$E$61V 

FPP_$E$62A 

PPP_$E$62V 

FPP_$E$62C 

FPP_$E$66A 

FPP_$E$66C 

FPP_$STRUNC 

FPP_$SNINT 

FPP_$DTRUNC 

FPP_$DNI]Srr 

FPP_$SMINV 

FPP_$SMINA 

FPP_$SMINC 

FPP_$SMAXV 

FPP_$SMAXA 

FPP_$SMAXC 

FPP_$DMINA 

FPP_$DiyiINC 

FPP_$DMAXA 

FPP_$DMAXC 

FPP_$CLA 

FPP_$CLC 

FPP_$CAA 

FPP_$CAC 

FPP_$CSA 

FPP_$CSC 



D.P. FAC := Float [((SP)+)] (Float 16 bit integer) 

D.P. FAC := Float [{SP)+] (Float 32 bit integer) 

D.P. FAC := Float [((SP)+)] (Float 32 bit integer) 

D.P. DO.W := Fix [FAC]; then Exit 

D.P. DO.L := Fix [FAC]; then Exit 

Convert D.P. FAC to Single Precision 

Convert Single Precision FAC to D.P. 

Take square root of FAC 

Take square root of DFAC 

EXP«FAC» 

DEXP«DFAC» 

A]JOG(<FAC» 

DLiOG«DFAC>) 

SIN«FAC» 

DSIN«DPAC» 

COS«FAC>) 

DGOS«DFAC» 

TAN«FAC» 

DTAN(<DFAC>) 

ATAN«FAC» 

DATAN«DFAC>)} 

ATAN2(<FAC>,((sp+)) 

ATftN2(<FAC>,(sp+) 

ATRN2 ( <FAC> , <CONSr> ) 

DATAN2 «DFAC> , ( (sp+) ) 

DATAN2 ( <DFAC> , <OONST> ) 

E$21(<FAC>,(sp)+) 

E$22«FAC>,((sp)+)) 

E$22«FAC>,(sp)+) 

E$22 «FAC> , <OONSr» 

E$61(<DFAC>,(sp)+) 

E$62«DFAC>,((sp)+)) 

E$62«DFAC>,(sp)+) 

E$62 ( <DFAC> , <CONSr> ) 

E$6u(<DFAC>,((sp)+)) 

E$66(<DFAC>,<GONST» 

FAC := Int[FAC] 

FAC := Nint[FAC] (Nearest integer) 

D.P. FAC := Int[FAC] 

D.P. FAC := Nint[FAC] (Nearest integer) 

FAC := Min[FAC, (SP)+] 

FAC := Min[FAC, ((SP)+)] 

FAC := Min[FAC, Next 4 bytes] 

FAC := Max [FAC, (SP)+] 

FAC := Max [FAC, ((SP)+)] 

FAC := Max [FAC, Next 4 bytes] 

D.P. FAC := Min[FAC, ((SP)+)] 

D.P. FAC := Min[FAC, Next 8 bytes] 

D.P. FAC := Max [FAC, ((SP)+)] 

D.P. FAC := Max [FAC, Next 8 bytes] 



Complex FAC 
Complex FAC 
Complex FAC 
Complex FAC 
Complex FAC 
Complex FAC 



((SP)+) 
= Next 8 Bytes 
= FAC + ((SP)+) 
= FAC + Next 8 bytes 
= FAC - ((SP)+) 
= FAC - Next 8 bytes 
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FPP_$CISA Complex FAC := ((SP)+) - FAC 

PPP_$CISC Complex FAC := Next 8 bytes - FAC 

FPP_$CMA Complex FAC := FAC * ((SP)+) 

FPP_$CMC Complex FAC := FAC * Next 8 bytes 

FPP_$CDA Complex FAC := FAC / ((SP)+) 

FPP_$CDC Complex FAC := FAC / Next 8 bytes 

FPP_$CIDA Complex FAC := ((SP)+) / FAC 

FPP_$CIDC Coirplex FAC := Next 8 bytes / FAC 

FPP_$CSTA Conplex Store FAC thru (SP)+ 

FPP_$CSTX Ccanplex Store FAC thru (SP)+ and exit 

FPP_$CSWAP Complex Exchange Real and Imaginary parts of FAC 

FPP_$CCNV Convert Single Prec to Complex (set imagFAC := 0) 

FPP_$COONJ Complex Conjugate (imagFAC := -imagFAC) 



nm /P l S¥i 



P N 30C R LngA)lsK 

RING page at [ 9800 | 0FF9C00 ] 

WRITE FUNCTION 
15 



READ FUNCTION 



+00 
+02 
+04 
+06 
+08 



XMIT COMMAND 



RCV COMMAND 



TMASK I unused 



DIAG COMMAND 



RING 
ID 



15 









+00 1 


XMIT STATOS 




+02 1 


RCV OTATOS 




+04 I 


TOASF 


1 unused 




+06 1 


DIAG STATUS 




+08 1 
4- 
1 




RING 


-+ 




ID 


+0C 1 




unused 




+0E 1 




unused 




+10 1 


IDS 


1 unused 




+12 1 


ID2 


1 unused 




+14 1 


IDl 


1 unused 




+16 1 


IDO 


1 unused 
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TmmjT ompw f ^oo i qff9 c oo i 

4000 xmit interrupt enable 

2000 xmit enable (start the xmit) 

1000 force xmit 

NOTES: 

1. To Start a xmit normally, use 6000. 

2. TO force xmit, use 7000. 

3. To stop a xmit that has already started, clear the 
xmit enable bit. 

4. Writing anything to this register clears the xmit 
interrupt. 

ppcExvg (xmm> r^8Q2 i qff9c q 2 i 

4000 enable interrupt 

2000 enable receive (start the receive) 

NDTES: 

1. To start a normal receive, use 6000. 

2. To stop a rev that has already started, clear the 

rev enable bit. 

T m^m 'T j g T ATpg \9 9 Q0 I QFF9C0 1 

8000 interrupt pending 

4000 interrupt enabled 

2000 busy 

1000 disconnected 

0800 biphase error 

0400 elastic store bfr err 

0200 no rtn (a complete pkt frame never arrived) 

0100 crc error 

0080 ack parity error (0=no error, l==error detected) 

0040 external error (err during EWA, e.g. parity, bus-error) 

0020 protocol error (the j^t hdr with FRCM ID never came back) 

0010 icopy (somebody Intended to CDPY -- was willing 

to rev) 
0008 ack byte errbit (somebody (an^^Dody!) set the "error 

detected" bit) 
0004 copy (sOTiebody did CDPY the pkt) 

0002 wack 
0001 under run (EMA didn't keep up with xmit data rate) 

NOTES: 

1. A successful xmit will have a xmit status of 0014 

2. A WACK will have a xmit status of 0012 



Perijiieral I/O 6-30 apollo confidential, internal use only. 



RECEIVE STATUS 19^0 2 I 0FF9C02 1 

8000 interrupt pending 

4000 interrupt enabled 

2000 busy 

1000 discx)nnected 

0800 bijAiase error 

0400 elastic store bfr err 

0200 timeout (The hdr of a msg was seen, but it never ended) 

0100 crc error 

0080 ack parity error (0=no error, l=error detected) 

0040 external error (err during IMA, e.g. parity, bus-error) 

0020 DMA end of range 

0010 icopy (somebody before me Intended to COPY) 

0008 ack byte errbit (somebody before me set the "error 

detected" bit) 
0004 copy (somebody before me did COPY the pkt) 

0002 wack (somebody before me WACKed the ptk) 

0001 overrun (DMA didn't keep up with rev data rate) 

DIAGNOSTIC S TAT U S \9Q% I 0FF9C0 6 1 

8000 interrupt pending (bad_pkt_ait_overflow interrupt) 
4000 interrupt enabled (bad_Ekt_cnt_overflow interrupt) 
2000 connected to the network 
1000 sticky bij^ase error (error seen since bit was 

cleared) 
0800 delay on (the delay is enabled) 

0400 sticky good_seen (good pkt seen since bit was 

cleared) 
0200 sticky elastic store bfr err (error seen since bit was 

cleared) 
OlFF bad packet count (9-bit counter for 1st detecting 
errs) 



KDTES: 



1. Counter is number of times this node found an 
error in a pkt going by (regardless of j^t target 
node ID) , found the error bit in the ackbyte 
clear, and so was the first to set the error bit 
to a one. 

2. The bad_pkt_cnt interrupt occurs when the counter 
counts from 255 to 256 (i.e. first uses its 
highest order bit) . 

3. The counter sticks at 511 if more than 511 errors 
are seen. 

4. Writing anything to low byte of diagnostic command 
register (see below) clears interrupt and all 
sticky bits. 
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Djfm)^ic co mm> \9^o^ i qf f9cq6 i 

8000 dm test (loop xmit DMA to rev ema) 

4000 enable interrupt (bad_pkt_cnt overflow intterupt) 

2000 connect (to the network) 

1000 disconnect (from the network) 

0800 delay off (disable the delay) 

0400 delay on (enable the delay) 

0200 snoop (accept all pkts but only set ackbyte 
for packets actually addressed to me) 

NDTE: 
Writing anything to low byte of clears interrupt and all 
sticky bits in diagnostic status register. 

TMft SK f^ 4 I QFF9 C0 4 1 

80 broadcast 

40 hardware diagnostic 

20 thank you 

10 please 

08 paging 

04 user 

02 software diagnostic 

01 xtypeS 

NOTE: 
Except for BEQftDCAST, these bits are software defined. 
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pmxx and PN60Q Ring^isk 

address: Controller #2 [ BCOO I FP9C00 ] 
Controller #1 [ B800 I PPAOOO ] 

{ today's Controllers are #2's ) 

Address Write function 



Read function 



OOBCOO 
OOBCOl 
00BC02 
00BC03 
00BC04 
00BC05 
00BC06 
00BC07 
00BC08 
00BC09 
OOBCOA 
OOBCOB 
OOBCOC 
OOBCOD 
OOBCOE 
OOBCOF 
OOBCIO 
OOBCll 
00BC12 
00BC13 
00BC14 
00BC15 
00BC16 
00BC17 
00BC18 
00BC19 
OOBCIA 
OOBCIB 
OOBCIC 
OOBCID 
OOBCIE 
OOBCIF 



Cylinder MSByte 

Cylinder LSByte 

Disk conmand register 

(reserved hole) 

Head number 

Sector 

Controller command 

(reserved tole) 

Network type mask 

Network receive command 

Network transmit command 



Cylinder MSByte 
Cylinder LSByte 
Disk status register 



Node ID 2 

Node ID 3 

Disk status MSB 
Disk status LSB 
Network rev stat MSB 
Network rev stat LSB 
Network tx status MSB 
Network tx status LSB 



Disk Interrupt ACK 

Network Trans Interrupt ACK - 

Network Rec Interrupt ACK 
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Address Write function 



Read function 



00BC40 
00BC41 
00BC42 
00BC43 
00BC44 
00BC45 
00BC46 
00BC47 
00BC48 
00BC49 
00BC4A 
00BC4B 
00BC4C 
00BC4D 
00BC4E 
00BC4F 
00BC50 
00BC51 
00BC52 
00BC53 
00BC54 
00BC55 
00BC56 
00BC57 
00BC58 
00BC59 
00BC5A 
00BC5B 
00BC5C 
00BC5D 
00BC5E 
00BC5F 



Disk DMA address 
Disk EMA count 
Disk UAA Address 1 
Disk IMA count 1 
Transmit EMA Address 
Transmit DMA count 
Transmit EMA address 
Transmit EMA count 1 
TMk command 
EMA request 
DMA single mask 
DMA mode 

E»1A clear byte pointer 
EWA master clear 

DMA all masks 



Disk IMA address 
Disk EMA count 
Disk EMA Address 1 
Disk EMA count 1 
Transmit EMA Address 
Transmit IMA count 
Transmit DMA address 1 
Transmit EMA count 1 
EMA status 



DMA temporary 
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Address Write function 



Read function 



00BC60 
00BC61 
00BC62 
00BC63 
00BC64 
00BC65 
00BC66 
00BC67 
00BC68 
00BC69 
00BC6A 
00BC6B 
00BC6C 
00BC6D 
00BC6E 
00BC6F 
00BC70 
00BC71 
00BC72 
00BC73 
00BC74 
00BC75 
00BC76 
00BC77 
00BC78 
00BC79 
00BC7A 
00BC7B 
00BC7C 
00BC7D 
00BC7E 
00BC7F 



Receive DMA address 
Receive E*1A count 
Receive DMA address 
Receive DMA count 1 
Receive 1 DMA address 
Receive 1 DMA count 
Receive 1 TifiA address 
Receive 1 DMA count 1 
EMA coinmand 
DMA request 
DMA single mask 
I»!A mode 

DMA clear byte pointer 
iMk master clear 

EMA all masks 



Receive DMA address 
Receive DMA count 
Receive DMA address 1 
Receive DMA count 1 
Receive 1 DMA address 
Receive 1 DMA count 
Receive 1 EWA address 1 
Receive 1 EMA count 1 
WiA status 



DMA temporary 



Cylinder Address Register 
MSB address: [ BCOO | FF9C00 ] 
15 14 13 12 11 



--»- 



I 



I 



CIO I C09 



-4- 



-+- 



LSB address: [ BC02 | FF9C02 ] 
15 14 13 12 11 



I C07 I C06 



C04 I C03 

H 



C02 I COl 



COO I 
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PRIAM Command Register 
address: [ BC04 i FF9C04 ] 
15 14 13 12 



+- 



-4- 



-4- 



-+- 



-+- 



I 1 I 1 1 



+- 



-4_ 



-4- 



-4- 



-4- 



Sequence Up = 
Sequence Down = 
Restore = 
Seek = 
Fault Reset = 

mSM Status Register 

address: [ BC04 | FF9C04 ] 





1 

1 

1 



|CMDRJTiWRITPT|DRVFLT| BUSY | CYL 1 SEEKFTi SEEKOK | READY] 



4- 



-4- 



-4- 



-4- 



-4- 



READY - The drive is up to speed, servo is locked on 

track, and the unit is in a state to read or 

write. 
SEEROK- SEEK CDWPLETE - This bit indicates the seek has 

completed successfully. 
SEEKFT- SEEK FAULT - A fault was detected during a seek 

operation. 
CYL - Head on cylinder 0. 
BUSY - T^e drive is in the process of executing a 

coimand and will not accept any other commands. 
DRVFLT- DRIVE FAULT - A fault was detected during a write 

operation or a drive unsafe condition was 

detected. 
WRITPT- WRITE PROTECT - The head selected is write 

protected. Write protection is set by switches in 

the drive or when the drive isn't sequenced up. 
CMDRJT- Control or register load comnand received while 

drive is not rea(^, or improper command received. 
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He ad/ D rive S elect 

address: [ BC08 | FF9C08 ] 
15 14 13 12 



I SEL3\| SEL2\I SEL1\| SELO\| x | H2\ 



Hl\ |H0\ I 



SEL3-SEL0 select the DRIVE: 



Drive #0=1 
1=1 
2=1 
3=0 



H2-H0 select the HEAD: 



Head #0 ■ 
1 
2 



Sector Select 

address: [ BCOA | FF9C0A ] 



I S4 I S3 i S2 



SI I SO I 



S4-S0 select the SECTOR (0-17): 



Sector #0 = 
1=0 
2=0 
3=0 

etc. 



Pisk Controller QpinmaDd 

address: [ BCOC I FF9C0C ] 
15 14 13 12 



I READ I WRITE IPORMAT! 



I X I INTE I 
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pj-gK (;:Qnti:Ql3.gr status 

address: [ BCIO | FF9C10 ] 



I BUSY |READY\|CRCERR|TIM3UT| | iBUSERRi OVRUN| 



I I 



BUSY - Controller has a disk READ, WRITE or FORMAT 
request pending or in progress. 

READY - PRIAM ready bit, indicates that the PRIAM is 
sequenced up, on cylinder and ready to accept 
READS, WRITES Or FORMATS. 

CRCERR- CRC on the last disk operation was in error. 
This bit is undefined except for disk READs. 

TIMOUT- The last disk operation didn't finish before 3 

revolutions of the disk. During a B^D or WRITE 
operation it is an indication that the drive has 
has been positioned to the wrong cylinder, 
sector number is too large, surface is unformat- 
ted, or there was a CRC error on the disk header. 

BUSERR- A BUS error occurred during last DMA transfer. 
IMA address register points past the erroring 
address . 

OVRUN - EMA overrun occurred during last disk operation. 

Status 1111110 000000000 

5432109876543210 

Controller busy IxxxOOxxOOxxxxxx 

PRIAM not ready xlxxOOxxOOxxxxxx 
Time out-sector error OOxlOOOOOOxxxxxx 

IMA bus error OOxOOOlxOOxxxxxx 

DMA over run OOxOOOOlOOxxxxxx 

CRC error OOlOOOOOOOxxxxxx 

Disk operation ok OOOOOOOOOOxxxxxx 

P&gket TypQ 

address; [ BCIO | FF9C10 ] 

15 14 13 12 11 10 9 8 

H H ^ H ^ ^ ^ 1 + 

IBRDCSTI T6 I T5 I T4 I T3 I T2 I Tl I TO I 
H H ^ H H ^ H H + 

BRDCST - Accept broadcast messages 

T6-T0 - Type mask, accept message if any bits in type 

field of message are set in corresponding bit of 

type mask. 
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Receive Coppend Register 

address: [ BC12 | FF9C12 
15 14 13 12 



I RBC I STOP I CX)N I DIS I x | x | x | INTE | 
H H H H -) H H H + 

REC - Enable receive. This informs the controller 

that the registers in the controller are set up 

to receive a message. 
STOP - Abort a previously posted REC. This will be 

successful if the controller has not already 

seen a message begin. 
CON - Connect to the ring. 
DIS - Disconnect from the ring. This also happens 

on reset. 
INTE - Enable interrupts to happen after a receive. 
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Receive Status Register 

address: [ BC12 | FF9C12 ] 

15 14 13 12 11 10 9 8 

H H H H H 1 H H 1- 

I BUSY I OON |CRCERR|TIM3UT| | EORERR | EUSERR I OVHJN| 
H ^ H H H H H 1 1- 

76543210 

H H H H H 1 1 1 h 

|MSGER\!ACKPE\|PKTERR| I I I ESBERR I BPHERR | 



BUSY - The cxDntroller is currently observing a 
message or a request is still pending, 

CDN - Itie controller is currently connected to the 
ring. 

CRCERR - The last message received had a CRC error. 

TnM)UT - The last message received started but didn't 
finish in 2**12 byte times. 

BOREKR - End of range error. One or both of the 
message fields was bigger than the OIA channel was 
set up for. 

BUSERR - A BUS error occurred during the EMA 
transfer. The DMA address register is pointing 1 
location past the point of the error. 

OVRUN - A EMA overrun occurred during the last 
receive. 

MSGER\ - No message error occured during the last 
receive. A message error is any error that can be 
detected by the microcode of the controller. 
Generally it checks for the packet protocol. 

ACKPE\ - Ack parity OK. No parity error was 
discovered in the ack bytes in the last receive. 

PKTERR - Either the transmitter or another receiver 
had an error in the packet. If the transmitter 
had an error in the transmission of the packet, 
one of the following errors occurred in the 
transmitter : 
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ESBERR - Elastic Store Buffer Error 

BPHEER - Bi-Phase Error 

OVHJN - DMA Overrun 

BUSERR - DMA bus error 

ACKPAR - Ack byte parity error 

SPTABT - Software abort 

NGOPy - No receiver enabled to copy this msg 

MSGERR - Message error 

If the receiver had an error in the reception of 
the packet, one of the following errors occurred 
in the receiver: 

ESBERR - Elastic Store Buffer Error 
BPHERR - Bi-Phase Error 
OVEON - EMA Overrun 

■ DMA bus error 

■ End of Range error in DMA channel 
• CRC error in packet 

ACKPAR - Ack byte parity error 

ESBERR - An error occurred in the modems elastic 
store buffer. 

BPHERR - An error occurred in the modems decode of 
the Bi-phase encoded data. 

Status 1111110000000000 

5432109876543210 

Controller busy IxxxOxxxxxxOOOxx 

Connected to ring xlxxOxxxxxxOOOxx 

DMA bus error OxxxOxlxxxxOOOxx 

DMA over run OxxxOxOlxxxOOOxx 

Bifiiase error OlxxOxOOxxxOOOxl 

Elastic buffer error OlxxOxOOxxxOOOlO 

Time out error OlxlOxOOxxxOOOOO 

Sync protocol error OlxOOxOOOxxOOOOO 

Ack t^e parity error 01x00x0010x00000 

CRC error 01100x0011x00000 

End of range error 0100010011x00000 

packet error 0100000011100000 

received ok 0100000011000000 
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Transmt CQinman^ Register 

address: [ BC14 | FF9C14 ] 



10 



I TMT I STOP IFTRANSICHIDISI x |DELAY i^DELAy| INTE I 
^ H ^ H H H H ^ + 

TS/fT - Enable transmit. This bit informs the controller 

that all the registers are set up for a message 

to be transmitted when the next token is 

received on the network. 
STOP - Stop a previously posted TPC. This will abort a 

request for a transmit. It will abort a packet 

if currently being transmitted, 
FTRANS - Force transmit. Allow the TMT to start even 

though no token has been seen. This bit must be 

accoirpanied by the TMT bit. 
CHIDIS - Disable the second transmit EMA channel from 

putting out any data. This will make for a 

length data field in the message. 
DELAY - Enable an additional 7 bit delay into the length 

of the network. This may be required to support 

the recirculation of the token, v*iich is 9 bits. 
NDELAY - Disable the 7 bit delay. 
imE - Enable an interrupt to be generated at the 

completion of the transmit. 
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Transmit Status Register 
address: [ BC14 | FF9C14 ] 
15 14 13 12 



BUSY I I ITDOUTI | IBUSERR| OVHJN| 



|MSGER\|ACKPE\IPKTEIRR| NCDPYl COPY | WACK | ESBERR I BPHERR I 

■i H H ■ H H H -I H + 

BUSY - The controller is currently transmitting a 
inessage or the request is still pending. 

TIMOUT - The last inessage transmitted started but didn't 
finish in 2**12 byte times. 

BUSERR - A BUS error occurred during the DMA transfer. 

The EMA address register is pointing 1 location 
past the point of the error. 

OVPDN - A DMA overrun occurred during the last transmit, 
transmit. A message error is any error that can 
be detected by the microcode of the controller. 
It is generally the packet protocol that is 
checked for. 

MSGER\ - No message error occured during the last 

receive. A message error is any error that can 
be detected by the microcode of the controller. 
Generally it checks for the packet protocol. 

ACKPE\ - Ack parity OK. ISfo parity error was discovered 
in the ack bytes in the last transmit. 

PKTERR - Either the transmitter or the receiver had an 
error in the packet. 
If the transmitter had an error in the 
transmission of the packet, one of the 
following errors occurred in the transmitter: 

ESBERR - Elastic Store Buffer Error 

BPHERR - Bi-Phase Error 

OVRUN - DMA Overrun 

BUSERR - MIA bus error 

ACKPAR - Ack byte parity error 

SPTABT - Software abort 

NCDPY - No receiver was enabled to copy this 

message 
MSGERR - Message error 

If the receiver had an error in the reception 
of the packet, one of the following errors 
occurred in the receiver: 
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ESBERR - Elastic Store Buffer Error 

BPHERR - Bi-Phase Error 

OVHJN - DMA Overrun 

BUSERR - I»1A bus error 

BORERR - End of Range error in DMA channel 

CRCERR - CRC error in packet 

ACKPAR - Ack byte parity error 



NCDPy - Ito receiver observed his node address in this 

packet and/or was enabled to copy this message. 
MSGCPY - The receiver successfully copied the message. 
WACK - A receiver observed his node id, but wasn't 

enabled to copy this message. 
ESBERR - An error occurred in the modon's elastic store 

buffer . 
BPHERR - An error occurred in the roodan's decode of the 

Bi-phase encoded data. 



Status 



1111110000000000 
54321098765 4 3210 



Controller busy 

IMA bus error 

EMA over run 

Biphase error 

Elastic buffer error 

Time out error 

Sync protocol error 

Ack byte parity error 

Negative ack 
Wack 

Packet error 
Message copied 



lOOxOOxxxxxxxxxx 
OOOxOOlxxxxxxxxx 
OOOxOOOlxxxxxxxx 












x 














X 


X 


X 


X 


X 


X 


X 


1 











X 














X 


X 


X 


X 


X 


X 


1 














1 














X 


X 


X 


X 


X 


X 
































X 


X 


X 


X 
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X 


X 


X 
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1 


X 


1 








































1 


X 


X 


X 


1 































1 


1 





X 


X 


































1 








1 


X 









Node ID Register 

address: [ BCOA | FF9C0A ] 

[ BCOC I FF9C0C ] 

[ BCOE I FF9C0E ] 



15 



14 



13 



12 



11 



ID23 I ID22 I ID21 | ID20 | ID19 | ID18 | ID17 | ID16 



ID15 I ID14 I ID13 I ID12 | IDll | IDIO 1 ID9 



ID? I ID6 I ID5 I ID4 I ID3 | ID2 I IDl | IDO 



PerijAieral I/O 
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Wh Control/gtatus Registers 
DMA Address address: 



[ base + ] I 

[ " + 4 ] 

[ •• + 8 ] 

[ " +C ] 



15 



12 



11 



10 



A08 I A07 I A06 I A05 | A04 I A03 I A02 | AOl | 



IVA16I IVA15I IVA14I IVA13 | IVA12I IVAll | IVAIOI A09 | 



Notice that the address is shifted right by 1. 



OWA Count address: 



[ base + 2 ] 
[ •• +A ] 
[ " + E ] 



12 



11 



10 



C07 I C06 I COS I C04 | COS | C02 | COl | COO | 



C15 I C14 I C13 



C12 I Cll 



CIO 



C09 



I 



1 I 1 I I I 



-•+- 



-+- 



-I- 



BIT 7 - DACK sense active high 
6 - DREQ sense active low 
5 - Extended write 
4 - Rotating Priority 
3 - Conpressed timing 
2 - Controller disable 
1 - Channel address hold enable 
- Memory to roanory enable 



C (15-00) is the desired count in words minus 1. 
Wh CcCTnand SRegister 
address: [ base + 10 ] 

15 14 13 12 11 10 9 



I I I 
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DMA Mode Register 
address: [ base + 16 ] 
15 14 13 12 



I I I I X I 

H ^ 1 H H 

BIT 7,6 - 00 - Donand mode 
01 - Single mode 

10 - Block mode 

11 - Cascade mode 
5 - Address decranent 

4 - Autoinitialize 
3,2 - 00 - Verify transfer 
01 - Write transfer 

10 - Read transfer 

11 - undef 
1,0 - channel select 

pyiA Request Register 

address: [ base + 12 ] 

15 14 13 12 



BIT 2 - Request bit 

1,0 - channel select 

DMA Mask Register 

address: [ base + 14 ] 

15 14 13 12 

H ^ H H 

I X I X I X I X 



BIT 2 - Set mask bit 

1,0 - channel select 
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DMA ALL Mask Register 
address: [ base + IE ] 
15 14 13 12 



+- 



-+- 



I 



-+- 



-+- 



-4- 



BIT 3 - Set channel 3 mask bit 
2 - Set channel 2 mask bit 
1 - Set channel 1 mask bit 
- Set channel mask bit 

DMA Status Register 

address: [ base + 10 ] 



15 



14 



13 



7 
6 
5 
4 
3 


- C3iannel 3 request 

- C3iannel 2 request 

- (Channel 1 request 

- Qiannel request 

- Channel 3 has reached TC 


2 


- Channel 2 has reached TC 


1 


- Channel 1 has reached TC 





- Channel has reached TC 
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Perij^eral I/O 



s mim I/O iNTEg^ACE FQs^ jm oQ 

SIO page at [ 8400 I OFFBOOO ] 

Sio lines iraplonented with a Signetics SC2681 DUART. 
Display ke^iDoard interface inplonented with a Motorola 
MC6850. 



Register summary: 



8400 OFFBOOO 

8402 0FFB002 

8404 0FFB004 

8406 0FFB006 

8408 0FFB008 

840A OFFBOOA 



Mode Reg. A (MRA) 
Status Reg. A (SRA 

Rev Hid Reg. A (RHRA) 
Input Port Change Reg. 

(IPCR) 
Interrupt Status Reg. 
(ISR) 



WRITE 

Mode Reg. A (MRA) 
Clock Select Reg. A (CSRA) 
Command Reg A (CRA) 
Transmit Hid Reg. A (THRA) 
Aux. Control Reg. (ACR) 

Interrupt Mask Reg. (IMR) 



8410 OFFBOIO 

8412 0FFB012 

8414 0FFB014 

8416 0FFB016 

841A OFFBOIA 

841C OFFBOIC 

841E OFFBOIE 

8420 0FFB020 

8422 0FFB022 



Mode Register B (MRB) 
Clock Select Reg. B (CSRB) 
Command Reg B (CRB) 
Transmit Hid Reg. B (IHRB) 
Output Port Config. Reg. 
(OPCR) 

— Set Output Port Reg. (OPR) 

Reset Output Port Reg. 

(OPR) 

Display Ke^x>ard Status/Comnand Register 

Display KejiDoard Data I/O Register 



Mode Reg. B (MRB) 
Status Reg. B (SRB) 

Rev Hid Reg. B (RHRB) 
Input Port Register 
(IPR) 



Peripheral I/O 
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WDE REGISTEat A. first access f 8400 i OFFBOOO 1 



17 16 15 14 13 12 1110 



H- 



I I 

0=5 bits/char 

1 = 6 " 

1 = 7 " 
11 = 8 

6 = even parity 
odd " 



= check parity 

1 = force parity 

1 = no parity 

1 1 = special multidrop mode 



= report error on each char 

1 = accumulate error info since last reset err 

coraramand 

= interrupt on receiver ready 

1 = interrupt on input FIFO full 



1 = drop RTS (OPO) v^en input FIFO is full 



MODE REGISTEat A. second & subsequent accesses 

(until mode register pointer reset) 



I7I6I5I4I3I2I1I0I 



1 1 

1 


i 
1 


1 
1 


1 

1=1 stop bit 


I 1 








= 1.5 stop bits 


1 1 


1 


1 


1=2 stop bits 



= transmit regardless of CIS (IPO) 

1 = wait for CTS to transmit 

= leave RTS as is 

1 = drop RTS (OPO) after transmitter disabled 



= normal mode 

1 = auto echo mode 

1 = local loop mode 
1 1 = remote loop mode 
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STATUS PEGISTE ^ ft f ^ 4 02 I QFFBQ Q 2 1 r ead- o nly 



|7|6I5I4l3i2|l|0| 



I I 

I 1 = input data ready^ 
I (reset by reading RHR) 
I 

1 = input FIFO full (reset v*ien 
RHR and no data in shift reg) 



1 = transmitter rea<^ (reset vdien 
THR loaded) 
1 = transmitter underrun (reset vAien 

THR loaded) 
rcver overrun (reset by reset error 
status crad) 
1 = rev parity error (reset by reset error 
status cmd) 
1 = receive framing error (reset by reset err status 
CTtd) 
1 = break received (reset by ???) 





8402 + 0FFB002 1 write-onlv 


7 


4 3 









I receive clock I transmit 


clock 1 




ACR[7]=0 


ACR[7]=1 




ACR[7]=0 


ACR[7]=1 


- 50 


75 


8 - 


2400 


2400 


1 - 110 


110 


9 - 


4800 


4800 


2 - 134.5 


134.5 


A - 


7200 


1800 (??) 


3 - 200 


150 


B - 


9600 


9600 


4 - 300 


300 


C - 


38. 4K 


19. 2K 


5 - 600 


600 


D - 


Timer 


Timer 


6 - 1200 


1200 


E - 


IP4-16X 


IP4-16X 


7 - 1050 


2000 


F - 


IP4-1X 


IP4-1X 
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COMMMP REGISTE]R A f 8404 I 0FFB004 1 write-only 



I 7 



4 I 3 



110 1 



I I 



1 = enable receiver 



■■ disable receiver 



1 = enable transmitter 



1 = disable transmitter 

= no-op 

1 = reset mode register pointer 

= reset & disable receiver 

1 = reset transmitter 

= reset error status 

1 = reset break-change interrupt 

= start transmitting break 

1 = stop tranmsmitting break 



must be 
RECEIVE/TRJ^MIT HOLDING REGISTER A r 8406 ! 0FFB006 



READ = top byte in input FIFO 
WRITE = byte of data to transmit 



imj^ PORT QiftNGE fiEGigTEy [ 8408 I QFFBQOg ] r ead- Q nly 
change in IPx: state of IPx: 



I 3 



3 12 1110 1 



IPO - Clear to Send (CTS) - A 
IPl - Clear to Send (CTS) - B 
IP2 - Data carrier Detect (DCD) - A 
IP3 - Data carrier Detect (DCD) - B 
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PmihJMY QOm W h RgGISTg R i g4Q8 I OF FB 008 1 w rite- Qn ly 



|7|615|4|3|2|1I0| 



I I 



I 



enab int on change in IPO 
enab int on change in IPl 
enab int on change in IP2 
enab in on change in IP3 
counter/timer stuff 
baud rate generator set select (see elk select reg) 
INTEa^UPT STATUS REGISTER f 840A I OFFBOOA 1 read-only 



5|4|3|2|1|0| 



I I I 

I I transndtter reac^ A 

I -H-rcver rdy or inpt FIFO full A 

H — ^ beginning or end of break A 



-counter ready (not used) 



transmitter reac^ B 
-receiver rea^ or input FIFO full B 
-beginning or end of break B 

-input port change status 



INTEa^UPT MASK REGISTER r840A I OFFBQOA V write-only 



17 16 



3 I 2 I 1 I 



Each bit enables the corresponding bit 
in the Interrupt Status Register. 

WP E I^GIg TE R B f 8410 I QFFBQ I Q 1 

See MDDE REGISTER A. 

STAT Ui g/ CU )C K S E fj B C T I^XiSTER B [ 84 1 2 I 0F FB 012 1 

See STATUS/CLOCK SELECT REGISTER A. 



PerijAieral I/O 
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qOW^ftND raxglSTEg^ PI M14 I QFFBQ14 1 

See COMMAND REGISTER A. 

RECEIVE/teM^igMIT HOLDING REGISTER B f 8416 I OFFB016 1 

See REGEIVE/TRANSMIT HOLDING REGISTER A. 

imTT voKT RExgijgTEK r g41A I WF^Q m 1 r ead- Qn ly 

H H + 

I IP7 I IP6 I IPS I IP4 I IPS I IP2 I IPl I IPO I 

H 1 1- 

IPO - Clear to Send (CTS) - A 
IPl - Clear to Send (CTS) - B 
IP2 - Data carrier Detect (DCD) - A 
IPS - Data carrier Detect (DCD) - B 
IP4-IP7 - Undefined 

O UTPUT PQKT (XWIgUPATXON REGIgrm J 941^ 1 QFFBQ I ft 1 
write-only 



I7I6I5I4ISI2I1I0I 

H H + 

Load with 0. This selects: 

OPO = Ready to Send (RTS) A 
OPl = Ready to Send (RTS) B 
0P2 = Data Terminal Ready (DTR) A 
OPS = Data Terminal Ready (DTR) B 
0P4 - 0P6 - Unused 
0P7 = Speaker control 

SET OUTPUT PORT REGISTER fOPRV \ 841C I OFFBOIC 1 

write-only 

H _ H + 

I 0P7 I 0P6 I OPS I 0P4 I OPS I 0P2 | OPl | OPO | 

H H + 

OPO - Ready To Send (RES) A 

OPl - Rea<^ To Send (RTS) B 

0P2 - Data Terminal Ready (DTR) A 

OPS - Data Terminal Ready (DTR) B 

OP4-OP6 - Unused 

0P7 - Turn off speaker 
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RESETT ourogr p qjr t ppGiff i m {(m) f 64 1 g t OF FPOIP 1 

write-only 

H ^ 1- 

I 0P7 I 0P6 I OPS I 0P4 I 0P3 I 0P2 | OPl I OPO i 



OPO - Ready To Send (RTS) A 
OPl - Ready To Send (RTS) B 
0P2 - Data Terminal Ready (DTR) A 
OPS - Data Terminal Ready (DTR) B 
0P4-0P6 - Unused 
0P7 - Turn on speaker 



DISPLAY KEYBOJ^ STATUS REGISTER- \ 8420 I 0FFB020 1 
read-only 



17 16 15 14 13 12 1110 1 



I receive data register full 

I 

transmit data register empty 

no DCD (always 0) 

no CTS (always 0) 

receive framing error 

receive overrun (reset by reading data) 

receive parity error 

interrupt request (cleared ty data read or write) 



Peripheral I/O 
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m^viM KEyBQj^ ( xmm) m^i^^rm, \ 8420 i qffbqzq 



write-only 



I 7 I 6 I 5 I 4 I 3 I 2 I 1 



-+ 



I I 

= clock/1 

1 = clock/16 

1 = clock/64 
1 1 = master 



=7 bits, even parity, 

1 =7 bits, odd parity, 

=7 bits, even parity, 

1 =7 bits, odd parity, 

=8 bits, 2 stop bits 

1 =8 bits, 1 stop bits 

=8 bits, even parity, 

1 =8 bits, odd parity. 



2 stop bits 
2 stop bits 
1 stop bit 
1 stop bit 



1 stop bit 
1 stop bit 



= Set RTS, disable transmitter interrupt 

1 = Set KIS, enable " " 

1 = Reset RTS, disable " " 

1 1 = Set RIS, transmit break, disable transmitter 
interrupt 
■■ Enable receiver interrupts (receive data register 
full, overrun, loss of DCD) . 



DISPLAY KEYBOMO DATA REGISTER I 8422 I 0FFB022 1 



READ = empties receive data register 
WRITE = loads transmit data register 
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SmiM. I/O lyrTERf^CE for DN4XX Pm DN600 



Data Input/Output, 
Control/Status , 
Data Input/Output, 
Control/Status, 
Data Input/Output, 
Control/Status, 
Data Input/Output, 
Control/Status, 
Bit-Rate Generator, 
Bit-Rate Generator, 
Bit-Rate Generator, 
Bit-Rate Generator, 



Line 
Line 
Line 1 
Line 1 
Line 2 
Line 2 
Line 3 
Line 3 
Line 
Line 1 
Line 2 
Line 3 



[ 8400 

[ 8402 

[ 8404 

[ 8406 

[ 8408 

[ 840A 

[ 840C 

[ 840E 

[ 8482 

[ 8486 

[ 848A 

[ 848E 



FFBOOO ] 
FFB002 ] 
FFB004 ] 
FFB006 ] 
FFB008 ] 
FFBOOA ] 
FFBOOC ] 
FFBOOE ] 
FFB082 ] 
FFB086 ] 
FFB08A ] 
FFB08E ] 



Data 

03 02 01 00 



Bit-Rate 

50 

75 

110 

134.5 

150 

300 

600 

1200 

2400 

2000 

2400 

3600 

4800 

7200 

9600 

19200 



Display Speaker 

SIO line is wired to the Display Speaker. 

- asserting RTS will emit a constant sound 

- toggling DTR with ROS set emits different tones 



Peri0ieral I/O 
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WRITE REGISTER 










1 D7 1 D6 1 


D5 1 


D4 1 


D3 1 


D2 I Dl I DO 1 












op 
-0 1 


Reg Select 










.1 I .1 










10 


11 2 " 










Oil 


.. 3 










10 


.• 4 .1 










10 1 


" 5 










110 


.. 6 .. 










111 


.. 7 













NULL code 












1 


Send Abort 









1 





Reset External 


Status Int 







1 


1 


Channel Reset 






1 








Enable Int. on 


next Rx Char 




1 





1 


Reset Tx Int. 


pending 




1 


1 





Error Reset 






1 


1 


1 


Return from Int(CH-A only) 





NULL code 






1 


Reset Rx CRC Checker 




1 


Reset Tx CRC Generator 




1 1 


Reset Tx Underrun/BOM Latch 




WRITE REGISTER 


1 








1 D7 1 D6 


1 D5 


1 D4 


1 D3 


1 D2 1 Dl 1 DO 


I 



D7 - Wait/Ready Enable 
D6 - Wait/Heady Function 
D5 - Wait/Ready on R/T 
D4 - D3 
Rx Int. Disable 

1 Rx Int. on 1st Character 

1 Int. on all Rx Chars (Parity affects vector) 



11"""" H .. (3oes not 
D2 - Status affects vector (CH-B only) 
Dl - Tx Int. only 
DO - EXT Int. Enable 



") 



WRITE REGISTER 2 (CHANNEL B ONLY) 
I 07 I D6 ! D5 I D4 I D3 I D2 I Dl I DO 



D7 - DO = Interrupt Vectors V7 - VO 
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WRITE REGISTER 3 



I D7 I D6 I D5 I D4 I D3 I D2 I Dl 

D7 - D6 

Rx 5 Bits/Character 

1 Rx 7 Bits/Character 

1 Rx 6 Bits/Character 
1 1 Rx 8 Bits/Character 

D5 - Auto Enables 

D4 - Enter Hunt Phase 

D3 - Rx CRC Enable 

D2 - Address Search Mode(SDLC) 

Dl - SYNC Character Load Inhibit 

DO - Rx Enable 

WRITE REGISTER 4 



1 D7 


1 D6 I D5 1 D4 1 D3 1 D2 1 Dl 1 DO I 


D7 - 


D6 










XI Clock Mode 





1 


X16 Clock Mode 


1 





X32 Clock Mode 


1 


1 


X64 Clock Mode 


D5 - 


D4 










8 Bit Prograinmed SYNC 





1 


16 Bit Programmed SYNC 


1 





SDLC mode (01111110 flag pattern) 


1 


1 


External SYNC Mode 


D3 - 


D2 










SYNC Modes Enable 





1 


1 Stop Bit/Character 


1 





1.5 Stop Bits/Character 


1 


1 


2 Stop Bits/Character 


Dl - 


= 


Odd Parity, 1 = Even Parity 


DO - 


Enable Parity 


WRITE REGISTER 5 


I D7 


i D6 1 D5 1 D4 1 D3 1 D2 1 Dl I DO 1 


D7 - 


DTR 




D6 - 


D5 










Tx 5 Bits (or less) Character 





1 


Tx 7 Bits/Character 


1 





Tx 6 Bits/Character 


1 


1 


Tx 8 Bits/Character 


D4 - 


Send BREAK 


D3 - 


Tx 


Enable 


D2 - 


SDLC/CRC-16 


Dl - 


RTS 




DO - 


Tx CRC Enable 
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WRITE RBGISTEK 6 



D7 1 D6 I D5 I D4 I D3 I D2 I Dl I DO I 



D7 - DO = SYNC Bits 7 
WRITE REGISTER 7 



1 D7 


1 D6 1 05 1 D4 1 D3 1 D2 1 


1 Dl 


1 DO 1 


D7 - DO = SYNC Bits 15-8 
SIO Read Control /Status Registers 






READ REGISTEK 




1 D7 


1 D6 1 D5 1 D4 1 D3 | D2 


1 Dl 


1 DO 1 


D7 - BREAK/ABORT * 

D6 - Tx Underrun/60M * 

D5 - CTS * 

D4 - SYNC/Hunt * 

D3 - DCD * 

D2 - Tx Buffer Enpty 

Dl - Interrupt Pending (CH-A only) 

DO - Rx Character Available 

* Used with External/Status Interrupt Mode 

READ REGISTER 1 


! D7 


i D6 1 D5 1 D4 I D3 I D2 


1 Dl 


I DO ! 



D7 - End of Frame (SDLC) 

D6 - CRC/Framing Error 

D5 - Rx Overrun Error 

D4 - Parity Error 

D3 D2 Dl I Field Prev Byte I Field 2nd Prev Byte ' 

10 3 

10 4 

110 5 
1 6 
10 1 7 
Oil 8 

111 1 8 
2 8 

DO - All Sent 

* Residue data for 8 Rx bits/character prograiraned 
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READ REGISTEIR 2 



I D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 
D7 - DO = Interrupt Vectors V7 - VO 



Write CRl or CR3 
Rd Status, Wr CR2 
Rd/Wr Timer 1, Hi 
RdA^r Timer 1, Lo 
Rd/Wr Timer 1, Hi 
Rd/Wr Timer 1, Lo 
Rd/Wr Timer 3, Hi 
Rd/Wr Timer 3, Lo 
Calendar Control 
Calendar Data Wr 
Calendar Data Rd 



8800 
8802 
8804 
8806 
8808 
880A 
880C 
880E 
8880 
8882 
8884 



I FFACOO ] 

I FFAC02 ] 

I FFAC04 ] 

I FFAC06 ] 

I FFAC08 ] 

I FFACOA ] 

I FFACOC ] 

I FFACOE ] 

I FFAC80 ] 

I FFAC82 ] 

I FFAC84 ] 



TOUOiPM) 



The touchpad sends approximately 30 data points per 
secx)nd, through the same SIO port (zero) as the keyboard, 
at a speed of 1200 baud. Each data point consists of four 
bytes, as follows: 

+ 



escape code I 

I 



E8 



I 



lo 8 
bits 
of X 



lo 4 : hi 4 | 
bits : bits | 
of Y : of X I 



hi 8 
bits 
of Y 



I 



byte 



byte 1 



4-7 0-3 
byte 2 



byte 3 



The range of X and Y coordinates 
1100. 



is approximately 30 to 



PerijAieral I/O 
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CHAPTER 7 
PROGRAMMING INFORMATION 



Physical Address Space 



I 



16K I 10 CDNPROL 
I PAGES 



128K I DISPLAY BITMAP 



MAIN 
MEMORY 




4000 



FIRST MEMORY BOARD 
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1 TRAPS & PROM 1 


4K 1 UNUSED I 


6K I UMMCC 1 


7K 1 UMATPEB I 


8K 1 GLOBAL RW DATA | 
1 1 


IM 1 GLOBAL LIBRARIES! 
1 1 


2M 1 PM STATIC DATA | 
1 , I 


1 GUARD SEGMENT | 
1 1 


I USER STACK | 
3M ! 1 


/ USER PROCESS / 

I PRIVATE DATA | 

1 1 7'=;m I - 1 


1 PER PROCESS 1 
1 SUPERVISOR SPACE! 


1 UNUSED I 
1 1 


14M 1 DEBUG WORK PROM | 


14. IM 1 1 
1 NUCLEUS 1 
I I 


15.75M I DISPLAY BITMAPS I 


15. 8M 1 10 OOOTROL 1 
1 PAGES & 10 MAP 1 



■ GLOBAL A BOUNDARY 





5FFF 
6FFF 
7FFF 

FFFF 

IFFFFF 
< 

207FFF 

20FFFF 

28FFFF 

BBFFFF 
<- 



PRVATE (USER lODE) 



PRIVATE (SUPERVISOR MODE) 



800000 

< GLOBAL B BOUNDARY 

EOOOOO 



FAQOOO 
FEOOOO 
1000000 



Programming Information 
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^SPRMRT,F:R T iANGUAGE SUMMARY 



Program format 



PRD(3RAM name,start-addr [^proc-sect [^data-sect] ] 

MODULE name [,proc-sect [, data-sect ] ] 

PRDC 

pure (Dode and data (no variables, no relocation) 

DATA 

read/write code and data (including all address 

constants ) 



more PRDC and DATA sections, as desired 

END 
Notes 

1. These pseudo-ops must not start in column 1. 

2. Use PROGRAM when writing a main program, to specify 
the start address. Use MODULE otherwise. 

Statement Syntax 

Comment: * any characters up to end of line. 

Instruction or Pseduo-op: 

[label] "opcode'' [operandi [ ,operand2] ] " [comment] 



• * of comment field must be in first character 
position of line 

• label field if present must begin in first 
character position of the line 

• " means one or more spaces 

• [ ] encloses optional portions 

• Assembler is not case-sesitive 
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Expressi on Syntax 

* means current location 

# means iitmediate operands 

$ means hex constants 

DB, SB, and SP are synonyms for registers A5, A6f and A7 
respectively 



Operators in decreasing priority: 






*r 


/ 










+ , 


- 










<r 


>, <=, 


>=f =, <> 


relationals 




« 


r » 




shifts 






& 






bitwise and 




! 






bitwise 


or 


?dejg 
ABCD 




BSET 


DBT 


MDVEA 


SEQ 


ADD 




BSR 


DBVC 


MDVM 


SF 


ADDA 




BTST 


DBVS 


MDVEP 


SGE 


ADDI 




BVC 


DCNT 


MOVEQ 


SGT 


ADDQ 




BVS 


DEFDS 


MUIB 


SHI 


ADDX 




CHK 


DBFS 


MULU 


SLE 


AND 




CLR 


DIVS 


NBGD 


SLS 


ANDI 




CMP 


DIVU 


NEG 


SLT 


ASL 




CMPA 


ELSE 


NEGX 


SMI 


ASR 




CMPI 


ENDC 


NOP 


SNE 


BCC 




CMPM 


EOR 


NOT 


SPL 


BCHG 




DBCC 


BORI 


OR 


ST 


BCLR 




DBCS 


EXG 


ORI 


STOP 


BCS 




DBEQ 


EXT 


PEA 


SUB 


BEQ 




DBF 


IFEQ 


RESET 


SUBA 


BGE 




DBGE 


IFF 


RQL 


SUBI 


BGT 




DBGT 


IFNE 


RDR 


SUBQ 


BHI 




DBHI 


IFT 


ROXL 


SUBX 


BLE 




DBLE 


JMP 


ROXR 


SVC 


BLS 




DBLS 


JSR 


RTE 


SVS 


BLT 




DBLT 


LEA 


RIR 


SWAP 


BMI 




DEMI 


LINK 


RTS 


TAS 


BNE 




DBNE 


L5L 


SBCD 


TRAP 


BPL 




DBPL 


LSR 


sec 


'TOAPV 


BRA 




DBRA 


MDVE 


SCS 


TST 



Programming Information 7-4 apollo confidential, internal use only. 



Define address c»nstant 
Define ASCII string 
Set location sector to end of 
data section 
Define constant 

Define symbols in descending 

order 
Define symbols in ascending 

order 
Define section (attributes 

are: READONLY, OVERLAY, 
INSTRUCTION, ZERO) 

End static range of using 

Define unintialized storage 

Do top of form 

End of source 

End of DEFS or DEFDS 

Declare entry point 

Define label as expr 

Declare external 

Enable listing 

Module header 
data-set] ] 



Inhibit listing 
Set location counter within 
section 
Set location counter to end 
of named section 
name [ ,start-addr 
[ ,proc-sect-name [ , 
data-set-name]]] Program header 
name Set location counter to end 

of named section 
An, expr Instruction's addressing 

modes; fields can assume 
expression in register An 



AC 


expr 


DA[.x] 


•string' [f...] 


DATA 




DC[.x] 


[r^)eat-cnt@] 




const-expr [,....] 


DEEDS 


expr 


DEFS 


expr 


name DFSECT [attributes] 


DROP 


An 


DS [.x ] 


expr 


EJECT 




END 




ENDS 




ENTRY [.y] 


name 


label EQtJ 


expr 


EXTERN [.y] name 


LIST 




MDDULE 


name 




[ ,proc-sect-name [ ,d 


NDLIST 




ORG 


expr 



.X -> 

•y -> 



• B, 
.D, 



.W, or .L 
.P, or .F 



(Byte, Word, Long) 

(Data, Procedure, Function) 



1. Only comments, EJECTS, and EQJs can precede the 
PROGRAM or MODULE pseudo-op. 

2. T!he USING pseudo-op generates no instructions. It 
simply tells the assembler that the address of the 
ejq^ression is in address register Ax. The assembler 
uses this information in forming the effective address 
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fields of instructions. Program instructions must 
load the address register with the address of the 
expression and and preserve it over the static range 
that begins with the USING pseudo-op. The DROP 
pseudo-op ends the static range. 

3. There is an implicit USING at the beginning of each 
assembly language module. The assembler assumes that 
A5 contains the address of the start of the 0^^$ 
section. DROP can be used to disable this. 

Register usage 

A5 - DB 
A6 - SB 
A7 - SP 



DEFS defines a structure, addressed in ascending order. 
DEFDS defines a descending structure. ENDS marks the end 
of a definition. 

For example: 



DEFS 4 (sp) 
a ds.w 1 
b ds.l 1 
c ds.l 1 



An assembly language module may have any number of 
sections. The assembler creates two sections 
automatically — a read-only, concatenate, instruction 
section named PROCEDURE?, and a read/write, concatenate, 
data section named DATA$. The names PROCEDURE? and DATA? 
can be changed in the PROGRAM or MOIXJLE statement. 

Sections and labels may have the same name. The name is 
recognized as a section name only in the context of DFSECT 
and SECT statements. 

DFSECT 

DFSECT defines a section. Its syntax is: 

section-name DFSECT section-attributes -list 

e.g. DEBUG? DFSECT READONLY 

Valid section attributes are READONLY, OVERLAY, ZEK), and 
INSTRUCTION. If no attributes are specified, the section 
will be a data, concatenate, read/write section. OVERLAY 
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sections overlay FORERAN GCWM3N blocks and Pascal 
sections of the same name. ZERO instructs the loader to 
initialize the section to zero before loading. 

SECT 

SECT directs the assembler to use a named section. Its 
syntax is: 

SECT section-name 

e.g. SECT DEBtX3$ 

This pseudo-op directs the assembler to put data or 
instructions in the specified section. It is similar to 
the PROC and DATA pseudo-ops, except that any section may 
be used. 

Usage Information 

Command line: 

ASM source-file [options] 

Options: (* indicates default options) 

* -L [<listing file>] Generate assembly listing 
-NL Suppress assembly listing 

* -B [<binary file>] Generate binary file 
-NB Suppress binary file 

-XREF Generate cross reference listing 

* -NXREF Suppress cross reference listing 

Source file names must end in .asm. Output listing files 
and binary files end in .1st and .bin, respectively. For 
example, asm foo looks for foo.asm as input, and creates 
foo.bin and foo. 1st. 

Conditional Assemb l y Pseudo-ops 

Note: ASM has conditional processor directives similar to 
PASCAL (see CONDITIONAL PROCESSING below) . 

IFEQ expr 
IFNE expr 
IFT expr 
IFF expr 
ELSE 
ENDC 
Notes 

1. IFT and IFNE assemble if expr <> 0. 

2. IFF and IFEQ assemble if expr = 0. 
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PEA 



ARGn 



PUSH ADDRESS OF LAST ARG 



PEA ARGl PUSH ADDRESS OF FIRST ARG 

rOVE.L ECBADR,AO GET ADDRESS OF ECB 

JSR (AO) JUMP AND PUSH PC 

ADD.W #4*n,SP POP ARG PTRS OFF STACK 

Subroutine entry; 

M3VE.L DB,-(SP) SAVE CALLER'S DATA BASE REG 

CLR.L -(SP) PUSH A RESERVH) WORD 

MDVE.L AO,-{SP) PUSH ADDRESS OF MY ECB 

^DVE.L 6(A0) ,DB LOAD MY DATA BASE FROM ECB 

LINK #autOsize,SB LOAD MY STACK BASE 

& DEFINE AUTOMATIC STORAGE 

MOVE.L 20 (SB) ,WORK GET ADDR FIRST ARG 



Subroutine return; 

UNLK SB 

ADD.W #8,SP 

MDVE.L (SP)+,1 
RTS 



RELOAD CALLER'S SB 
POP LINKAGE STUFF 
RELOAD CALLER'S DB 
RETURN TO CALLER 



See also STACK FRAME, ECB. 

Note: registers other than DB, SB, SP not preserved. 



Programming Information 
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gO^OITIQNA fc PROCEgglNg 

Conditional processing applies to both PAS and ASM. 
Coinmand L ine Syntax 

pas [filename] -CDNFIG namel name2 ... 
Conditional Compilation Control Structure Syntax 



%if <predicate> %then 

text 
%elseif <predicate> %then 

text 
%else 

text 
%endif 

<predicate> is of the form: 
name 

not <predicate> 
<predicate> and <predicate> 
<predicate> or <predicate> 
(<predicate>) 

Additional Syntax: 
%var namel name2 . . . ; 

%enable namel name2 ...; 
%config 

%error 'string' 
%waming 'string' 
%exit 
((%elsif, %elsifdef, and %end nay also be used)) 

Syntax Restrictions 



%ifdef <predicate> %then 

text 
%elseifdef <predicate> %then 

text 
%else 

text 
%endif 



— attribute name 

— highest precedence 

— "and" higher than "or" 

— lowest precedence 

— grouping 



— enumerate (declare) set of 
valid attributes 

— enable attributes 

— predeclared attribute 

— generate compiler diagnostic 

— generate compiler diagnostic 

— Stop processing this file 



Lines must exclusively contain either conditional 
compilation directives or language source text. 

Only attribute names given on the command line 
and names created with %var may be used in a 
<predicate> . 



%error and 
themselves. 



%warning must be on lines by 
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Names must be declared in a %VAR statement before 
being used. Names given on the command line with 
-(X)NFIG must also appear in a %VAR statement 
before being used in a predicate. 

A name evaluates to 1RUE in a %IF/%ELSEIF 
statonent if it is enabled on the command line 
with the -CDNFIG option, or enabled with a %ENABLE 
statonent. 

A name evaluates to TEUE in a %IFDEF/%ELSEIEDEF 
statement if-and-only-if it is declared with a 
%VAR statonent. 

The pre-declared attribute name %OONFIG is "BRUE 
iff a -CDNFIG option was given on the command line 
with non-null arguments. 

Declaring an already declared name will result in 
a warning. Using an undeclared name will result 
in a warning. Enabling a name that is already 
enabled will result in a warning. 
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ENTRY CONTROL BLOCK (ECB) 

(type db_$ecb_rec in /us/debug/db. debug $. ins. pas) 
15 



+00 1 
+ 

1 

+ 

1 


JUMP 

TO 

PROCEDURE 


1 

+ 
1 
+ 

! 


.jmp 
.cs 


+06 1 

+ 
i 


— > DATA 
AREA 


1 

+ 
1 


.db 


+0A I - 


BIANDI 


.keys 


+0C 1 

+ 
1 
+10 +-- 


DEBUG 
INFO 


1 

+ 

1 

— + 


.debug 



B = 1 => Stop looking back in stack for inhbt routines 
I = 1 => Inhibit async faults for routine 
A = 1 => Apollo software 
N = 1 => Debug info present 
D = 1 => DB reg not saved 
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SUFFIX 


MEANING 


RECOGNIZED BY 


.ASM 


Assembler source 


Assembler (input) 


.BAK 


Backup file 


Display manager (output) 


.BIN 


Binary file 


Compilers (output) 


.END 


Binder 




.BS 


Boot Shell command 


Boot Shell 


.C 


C source 


CC (input) 


.DATA 


Data file 




.FTO 


FORTRAN source 


FTN (input) 


.HLP 


Help text 


HELP command (input) 


.INS 


Insert file 




.LST 


Listing file 


Ccxnpilers (output) 


.MAP 


Map file 


Binder (output) 


.PAS 


Pascal source 


PAS (input) 


.RFC 


Run file converter 


RFC command (output) , 
/sysboot (input) 


D3M SUFFIX MEANING 




.DDL 


Schema, subschona, aggregate schena DDL 


.FMT 


Output from the RDL 


.LST 


ASCII listing of the schema, subschana. 




aggregate schena compiler 


.RPT 


Output from the D3M/K)RMATTER 


.CMD 


Executable D3M/DATAVIEW commands 


.RDL 


Source for report writer 


.UWA.XXX UWA definition 


generated by SSCH 


AUX SUFFIX MEANING 




.C 


C compiler 




.0 


Binary file 


from compiler 


.H 


C insert file 


SCRIBE 


SUFFIX MEANING 




.MSS 


Manuscript 




.ore 


Outline 




.LPT 


Linepr inter 


.AUX 


Auxiliary 




.ERR 


Error listing 



These conventions are not requirements; you can give a 
file any name you like, within the syntax rules. The 
operating system does not check a file's contents against 
its name. However, some programs assume that the names of 
input files end with a particular suffix. For example, 
the FORERAN compiler requires that the names of its input 
files end in .FTO. 



Programming Information 
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PATHNAME SYI^CftX 

Symbol Starting Point 



// 


Network root directory 


/ 


Node entry directory 


~ 


Naming directory 


\ 


Parent directory 


. or none 


working directory 


' 


/sys/node_data [ .nn] 



Legal characters in names: 

A-Z 
a-z 
0-9 

$ (dollar sign) 
_ (underscore) 
(period) 

Names cannot start with "_", ".", or digits. 

Valid pathnames: 

/PASC3\L 

VlISC/SAU_SCXJRCE 

/A'S/INS/STOEAMS . INS . ETN 

"com 

~link_name 

PASCAL EXTENSIONS 

PAS compiler ; Features for internal Apollo use only are 
marked with (*) . 

A Pascal "procedure" or "function" may be given a variety 
of attributes or options vAiich may be used to change the 
behavior of the routine or the syston usage of the 
routine. 

YfiL PN^; (*) 

"V7U4_PARAM" is an attribute which can be specified for a 
procedure or function. When it is given, arguments vdiich 
are not to be changed by the called routine (i.e. 'value' 
arguments and 'IN' arguments) and v^ich are 32 bits or 
less, are passed by "value" instead of by "reference". 
This makes the code a little more efficient. If you use 
this attribute, you may NOT invoke the routine from 
Fortran or C. Note that VAIcPARAM is superfluous if the 
INTERNAL attribute is used, or the routine is nested. 
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Example: 

FUNCTION fnd_jiame (IN pname : IDNLNJRBC; 

IN pdef_flag : BOOLEAN) : OBJBCT_ETR; 
VALJPARM; EXTERN; 

QPTI Q^^SO C l a use 

The "OPTIONS" clause is another way of giving procedure or 
function attributes. It allows you to group your 
attributes in one place. If you use the "OPTIONS" clause, 
you rtvay NOT have attributes outside it. Furthermore, the 
"OPTIONS" clause permits additional attributes. 

In the example above, the function could have been 
specified as follows: 

FUNCTION fnd_jiame (IN pname : IDNLN_REC; 

IN pdef_flag : BOOLEAN) : OBJECT_PTR; 
OPTIONS (VAL_PARAM, EXTERN); 

Note that the attributes of VZ^_PARAM and EXTERN are 
separate by commas in the OPTIONS clause. 

Furthermore, the following attributes, if desired, may 
ONLY be given in an OPTIONS clause. These are: 

INHIBIT : (*) 

The inhibit attribute sets a bit in the ECB flags v^iich 
inhibits asynchronous faults for the routine. 

BACKSTOP : (*) 

The backstop attribute sets a bit in the ECB flags vAiich 
stop looking back in stack for "inhibit "ed routines. 

VApTART,F« 

The variable attribute allows a variable nuirber of 
arguments to be given to the routine invocation. The 
number of arguments may be less than or equal to the 
number of parameters in the declaration. It may NOT be 
more. It is up to the writer of the routine to know how 
many arguments were actually passed. Generally, some kind 
of argument count should be given as one of the arguments 
(such as the first one) . 
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STA CK FRAME 



SP —> 


Automatic j 
Storage I 


SB — > +00 


Caller's SB I 


+04 


— > ECB 1 


+08 


(unit list) 1 


+0C 


Caller's DB | 


+10 


PC for Return I 


+14 


— > ARGl 1 


+18 


~> ARG2 I 




1 


+10+4*n 


~> ARGn 1 







+ 

I 
I 
I 

V 

PE^EVIOUS 

STACK FRAME 



Caller's DB is an optional field. 
ECB signals that it is not present. 



•DB not saved' bit in 



STATUS WM) 

("status_t" in base.spo.bbas) 
31 24 23 16 15 



I FSSSSSSS I AMMMMMMM i CCCCCCCCCCCCCCCC | 



F = 1 => module couldn't handle error (fail bit) 

S..S - Subsystem identification 

A = 1 => asynchronous fault; only set during delivery 

of fault (.async) 
M. .M - Module identification 
C. .C - Module-specific error code 

See also CHAPTER 4 ERROR CODES. 
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CHAPTER 8 
SYSTEM ESBUGGING 



DEBUG COMMAND EXTENSIONS 

The following cxDinmands and other items are available in 
the standard DEBUG, but are not advertised to the public. 



REGS — Display the registers of the target 
program. 

DB — Invoke the machine-level debugger EB (see 
below) . 

VA — Show the Virtual Address of current program 
location, odb named routine, or a list of 
variables: 

VA [{ var [,..., var] I -Routine [<routine-name>] }] 

VA by itself shows the current symbolic location 
and the virtual PC. 

VA -Routine [<routine-name>] shows the starting 
address of the named routine, or the current 
routine if the name is omitted. 

VA var [,..., var] shows the address of each 
variable. 



OptiohP to Current Coinwandg 

Breakpoint 

Breakpoint has an option to set a breakpoint on a virtual 
address. The formats are: 

Breakpoint -VA va_number 

or 
Breakpoint -VA routine-name\rva_jiur±)er 

The -VA option must be given. Then, if "va_number" is 
given, this is take to be some virtual address v^ere a 
breakpoint will go. 

If "routine_name\rva_nuirt)er" is given, then the routine is 
found, and the "rvajiumber" is assumed to be a 
ZERO-RELATIVE number v^ich is added to the start of the 
named routine to make a virtual address breakpoint. 
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Remember that DEBUG assumes base 10; hexadecimal numbers 
must be given with a leading "16#". Also, ^D CHECK is 
done to see if the number sujplied is legal. 

Delete 

Delete has an option to ranove breakpoints made with the 
-VA option. The formats are: 

Delete -VA va_jiui±>er 

or 
Delete -VA routine-name\rva_number 

MisgellaneQus 

The List coimand is unchanged; you cannot list these -VA 
breakpoints exclusively. Listing all breakpoints will 
show them, however. 

DEBUG has another invocation option viiich will show a 
brief section map of the loading of the target program. 
The option is "-smap", and it must come BEFORE the target 
name. Example: 

$ debug -sraap zd/z.63.bin 

Section Map: 

# Location Size Name 

1 002EA768 000002F4 PRDCEDURE$ 

2 00300000 OOOOFEDO DATA$ 

3 002EAA5C 00000A76 DEBUG$ 

The section nap is always displayed on ERRDUT. 

Also, here is some useful information v*iich IS PLBLIC, but 
vi^ich people often forget how 'to do. 

There are 3 debugger names v*iich DEBUG looks for. If it 
finds them, it does sane special things: 

^cr (macro name; made with MACRO command) 

^max_array_dim (dekxigger variable; made with SET command) 
"maK-Var.J.en (debugger variable; made with SET corarand) 

Note that "help examine" explains the ''max_. .. names, and 
"help macro" explains the ^cr name. 



System Debugging 8-2 
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DB (MACHINE LEVEL DEBUGGER) 

You enter the IB dehagger by entering the DB command from 
within a shell. Ihe formats of the internal DB commands 
follow. 



dl 


invoke emt 


ef 


enter fim 


help 




in <path> 


install library 


lo <path> 


load program 


ma <path> [-ex; 


] map a file 


pc 


display current pc 


fa 


display last fault address 


fc 


display last fault code 


sh 


invoke new shell 


ss 


single step 


tb 


traceback current stack 



crash analysis commands: 

a{biw|l}[e] <sym> access via symbol name 
am <path> load Aegis Map 
as [<asid>] set/display current as id 
aste <addr> I <astex> print contents of aste 



display pcb (first ten if no pid 

entered) 
convert db address to virtual 

address 
try to find stack frame in 

addr - addr+1024 
get (pbu) dcte 
enter mapped mode 
mapped search (just like md's 's') 
enter physical (normal) mode 
convert fpi to virtual address 
St display status at crash 

ts <pid or addr> traceback stack 
uid <hi> <lo> I <addr> interpret uid 
vd <addr> convert virtual address to db 

address 
vp <addr> convert virtual address to ppn 
v^[p|dle] <sym or addr> look up [proc|data|ecb] or 
address in aegis map 

You execute from the DB debugger by entering the q comontend 
in response to the ! prompt as follovre: 



dp [<pid>] 

dv <addr> 

ff [<addr>] 

gd <unit> 

m 

ms <args> 

P 

pv <addr> 



I q 
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Syston Debugging 



Lights Prog ram 

Execute the lights program to show network status from 
within the DB debugger as follows: 

!LI 0FF9C12 {virtual address of receive register} 

Do not execute the lights program from a color node. It 
will crash the network. 

The transmit and receive status registers are displayed at 
the bottom of the screen. These register are described in 
Chapter 6 Perijiieral I/O. To use the lights program do 
the following: 

• Exit from EB with the q command. 

• Execute NETSTAT shell commands to send tokens 
across the network. 

• Study the status bits in the receive status 
register . 

To exit from the lights program execute the following 
commands : 

$ DB {to re-enter DB environment} 

1 LI {Provide address of zero to lights program} 

! q {exit from DB environment} 

<ctrl> F {remove lights from bottom of screen} 
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A <location> Access location 

B <location> Breakpoint 

C <start> <end> <target> Copy Monory 

CA <start> CALL Subroutine 

D <start> <end> <itQns/line> Dump Memory 

DI <tYpe><unit> <log vol> Define Disk 

DL Down-line Loader 

EX <f ilename> Load and Execute File 

F <start> <end> <word> Fill Manory 

G <location> Jump to Location 

ID Lists SAUn Directories 

ID <f ilename> Load File 

M Map Address Space 

RE Reset Syston 

S <start> <end> <value> <mask> Search Memory 

SH <0-3> Spindovm Winchester 

P Unmap Address Space 

V <start> <end> <target> Verify Monory 



A [<size_j5pec>] <location>[<base_^pec>] 

Accesses <location> and prints address and contents 
according to <size_spec> and <base_spec>. 

B [<location>] 

Sets/clears breakpoint at location specified. Brealq»int 
is not inserted until G coitmand. Previous instruction 
reinstalled on breakpoint entry or vector entry. 

C <start> <end> <target> 

Copies memory defined by bounds <start> to <end> onto 
memory starting at <target> through 
<target>+<end>-<start> . 

CA <start> 

Calls the subroutine viiich starts at <start>. All 
registers saved from the last entry except AO are restored 
immediately prior to the call. 
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D [<size_spec>] <start> <end> 

< it €ins_pe r_line > [ <base_spec> ] 

Dumps memory defined by bounds <start> to <end> onto 
terminal printing address followed by specified 
<itQnsjper_J.ine> . Default is one per line. The <size_spec> 
controls the iton-size to be dun^d: byte, word, long, 
instruction. 

DI <W>|<F>i<N> [<nn>}|<S> <0-3> <1-10> 

Disk defines the boot device: Winchester, Floppy, Node 
(nn) , Storage Module unit 0-3 , and logical volume 1-10 . 
Defaults are: W, 0, 1. 

DL 

Transfers control to the down-line loader. 

EX <filename> 

Execute restores the named file from the "SAU" directory 
of the boot device and transfers control to it. After the 
restore is complete, the IDW, HIGH, and START addresses 
are displayed. 

F <start> <end> [<word>] 

Fills manory defined by bounds <start> to <end> with a 
word value <word>. 

G [<location>] 

Juir^ to <location> after inserting breakpoint (if any) , 
restoring all registers and SR. 



List directory displays the contents of the "SAU" 
directory of the boot device. 

ID <filename> 

Load restores the named file from the "SAU" directory of 
the boot device. The IDW, HIGH, and START addresses are 
displayed. 

M 

Maps address space and enables ramu. Monory rearranged as 
shown under Address Space in Chapter 2. 
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Reset executes the RESET instruction. If entered viiile 
running on CPU B, a second RESET instruction is executed 
for CPU A. The debugger will initialize and wait for 
terminal input. This command also enables the POWER-OFF 
key. 

S [<size_spec>] <start> <end> <value> 
[<iiiask>] [<base_spec>] 

Searches memory defined by bounds <start> to <end> for 
<value> through optional <mask>. If <mask> is not 
specified it defaults to $FFFFFFFF. The <size_spec> 
controls the item-size to be searched: byte, word or 
long. 

SH <0-3> 

Shuts down Winchester unit and acknowledges outstanding 
interrupts. This command also enables the POWER-OFF key. 



Turns off mapping. MMU is assumed at FFB400. 

V [<size_spec>] <start> <end> <target>[<base_spec>] 

Verifies equality of two memory areas defined by <start> 
to <end> and <target> to <target>+<end>-<start> . If a 
discrepancy is found the address in the first area and the 
contents of each are printed in the appropriate format. 
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<coramand>[<size_spec>] [<paraineter_list>] [<base_spec>] 

<coinirand> ::= A|B|C|D|DL|F|GlS|V|<empty> 

<size_spec> ::= :I|:B|:W|:L 

<paraineter_list> ::= <paraineter> ... [up to 4] 

<parameter> ::= <nuitLexp>iDniAn|(XR|SR| 

(An) I <nuitLexp> (An) |<nunL_exp>(<index_spec>) | 
<:nuiii_exp> (An, <index_spec> ) 

<nuiiL_exp> ::= <nuin> | * | <nuin_exp>+<nuin> | <nunL_exp>-<nuin> 

<num> : : = <simple_nuiiiber | $<siinple_nuniber> | 

<base>$<simple_nuiTiber> | -<nuin> | <quoted_str ing> 

<base> ::= <siinple_number> 

<quoted_string> ::= '<letter> ... <letter>' [up to 4] 

<index_spec> ::= An.W|Dn.W|An.L|Dn.L 

<base_spec> ::= :0|:D|:H|:A 



I ::= instr-sized items, output in mnemonic format. 



= byte-sized items, output in numeric format. 
= word-sized itans, output in numeric fornat. 
= longword-sized items, output in numeric format. 



Parameters are evaluated to a memory location or to an MD 
saved register, [e.g. Dn, An] or to a location computed 
from a saved register [num(An)]. Up to four parameters 
may be required. Unspecified parameters are set to zero. 

::= numbers and iimiediate constants printed in octal. 



= numbers and imnediate constants printed in dec. 
= numbers and immediate constants printed in hex. 



A ::= numbers and iirmediate constants printed in ASCII. 
All numeric input defaults to hexadecimal. $num implies 
hexadecimal. <base>$num implies base is <base> [ 8$777 is 
octal, 2$1001 is binary ]. <base_spec> and <size_spec> 
may be specified anyv^ere in the command line as well as 
anyv^ere in A command input (except in quoted strings) . 
All addresses and offsets are printed in hexadecimal 
regardless of <base_spec>. 



System Debugging 
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CRASH ANM.YSIS 



Most fatal errors recognized by Aegis will be reported by 
the craslusystem routine, v*iich will point address 
register (AO) at a standard error code (see Chapter 4 
ERRDR CODES) and execute a TRAP instruction, causing entry 
to the ERCM irmenonic debugger with an "S" code (see 
MNEMONIC DEBUGGER ERROR (DDES in Chapter 4) . Type 

A (AO):L 

and look up the resulting long-word displayed in the list 
of Aegis error codes. If AO is pointing to a standard 
code, you have the iitmediate reason for the crash; if it 
doesn't, something strange has happened. In either case, 
A6 (SB) will probably point to the stack frame of (1) the 
routine that called crash^systom (vAiich doesn't push a 
frame) or (2) the routine that blew up. Refer to Stack 
Frame format to trace back the BCB addresses of the 
callers leading to the crash. 

Other useful things to look at: 

Bit 2 of the Bus Status Register (word at FFB40A) : 
if set then CPU B was running. 

MMU Status Register (long word at FFB404) : 

Contains virtual address of last MMU miss (see MMU 
Status Register) . 

In AEGIS' DATA$ section (see map of AEGIS): 

ERDC_$CURRENT (word) = PID of current process. 

PCBR + (current PID*4) = PCB of current process (see 

PCB). 

CPUB_£TATUS (long word) = last error code from CPUB 

(only if now on CPUA) . 
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SYSTEM DUMPS 



This routine saves the state of the syston at the time of 
the crash and allows you to write the saved information to 
one of the following: 

• A floppy diskette 

• A file on another node 

The dunp routine copies the MMU, RING, and DISK registers 
to main memory, and then writes their contents to disk or 
file. After the registers have been copied, physical 
memory is dun^d, starting at $100000 and continuing 
through $200000 (1 Mb) , skipping missing memory boards 
v^ere necessary. On completion, the dunp routine executes 
a TRAP instruction and returns to the Mnemonic Debugger 
(MD). 

If a disk error occurs v^iile the dunp routine is 
executing, the operation that encountered the error is 
retried 25 times. If, after 25 attempts, the operation 
has not successfully completed, the dunp routine skips the 
current record and page and resumes processing with the 
next sequential page. 

To use this routine, follow these steps: 

1. To dump to a diskette, insert a diskette into the 
floppy diskette drive of the Disk Storage Option. 
The diskette most already be formatted (with 
INVOL) for 1231 blocks, and must be write-enabled. 
(To write-enable the diskette, cover the 
write-enable hole with a guimied label.) 

2. Issue the sequence of MD comnands listed below. 
The commands listed below use the following 
conventions. 
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Conventions 

<RETURN> Press the Return key 

[junk] Irrelevant value returned by imemonic debugger (MD) 

[SP] Nuntoer representing the Stack Pointer value 

$ Prefix used to identify numbers as hexadecinal to MD 



MD Commands 



Comments 



>D A7:L<aRErURN> 
nnnnnnnn: xxxxxxxx 



Get Stack Pointer 

Note value displayed (xxxxxxxx); 

it is the 

Stack Pointer in hexadecimal. 
Reset the systan 



>RESET<REOTRN> 
><RErURN> 
MD mnv/dd/yy 

>A 100000 :L<RETURN> Store Stack Pointer 

100000: [junk] $xxxxxxxx[SP]/ Replace junk with Stack Pointer 
value (xxxxxxxx) from above; 
enter / 
Then execute either 



>G 100C00<RErURN> 



Start DUMP to floppy 



n nn is the node id of the node on 

vAiich the dump file is created. 
The memory dump 
routine returns the name of 
the duiip file. 

:04 Start the DUMP to a file 

3. When the dump routine is complete, it executes a 
TRAP $F instruction and returns to MD. 

If the system appears hung, make sure the ^DRMAI/SERVICE 
switch is in the SERVICE position and type CrRL/<RETURN> , 
to pass control to the mnemonic debugger (MD) , If this 
fails, press the RESET 

switch. 
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Syston Debugging 



/SYgTEST/SSR OTTT. 



The following comnands are available for syston debugging 
in /SYSTEOT/SSIUn'IL. 

• BCR — BINARY_CROSS_PEFERENCE produces a cross 
reference from a list of dDject modules, viiose 
names are read from standard input. Only the 
global symbols referencable from outside the 
module are cross referenced. 

Usage: BCR 

• DISK_ERR — Displays information about last 
recorded disk error. 

Usage: DISK_ERR 

• DMPF — Dump_file dunps a file of any type to 
STDOUT interpreted in hexadecimal and ASCII. If 
hex_start_offset is given, it specifies the byte 
of the file at viiich to start dunping. If 
hex_end_offset is given, it specifies the byte of 
the file at viiich to stop dumping. The first byte 
of the file is at offset 0. By default Dump_file 
dumps the entire input file. 

Usage: DMPF input_pathname [-From hex_start_offset] 
[-To hex_end_offset] 

• EMFD — FORMAT_PROCESS DUMP formats a process dump 
and writes the formatted duirp to standard output. 
Process dunps are made by the process nanager v*ien 
a process terminates abnormally and appended to 
the file " ^node_data/proc_dump" . Information 
included is similar to that provided by the 
FAULT_STArUS (FST) and TRACE_BACK (TB) commands. 

The pathname (s) are the name{s) of files 
containing unformatted process duiips. If none is 
given, " ^node_data/proc_duiip" is assumed. The 
explicit dump file name facility allows dumps to 
easily be saved by copying the 

" ^node_data/proc_dump" file. 

Usage : FMH) [pathname . . . ] 

• LTBL — Prints the debug line number table 
Usage: LTBL (enter c±)ject module, the help) 
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• NETEX — Provides network statistics for all nodes 
in the network. 

Usage: NETEX 

<ctrl> Z to stop and display information 

• OBJEMP — Durrps an object (.bin) file 
Usage: OBJEMP infile [-L[IST] [outfile|-]] 

• KENGDDG — Monitors network traffic in and out of 
a node 

Usage: RINGLOG [-start | -stop | -read] 

-Start activate ring network message logging 
-Stop deactivate ring network message logging 
(if active) and display current contents 
of the log. (This is the default 1) 
-Read display current contents of the log. 
(Different from STOP because STOP 
deactivates logging if it is active. 

• FWVOL — RWVOL reads one jiiysical disk address at 
a time, and puts it into a buffer in manory. The 
program first asks you to specify the controller 
type, and then to specify v^ether you want to read 
(R) or write (W) the disk address. If you plan to 
write to the disk, first choose the "R" option to 
read the address first. 

When you choose the "R" option, the program asks 
you to enter the physical disk address (Daddr;) to 
be read; enter it in hex. The program next asks 
you for the memory address to be used for the 
buffer containing the data it reads from the 
disk. If you are reading only one record at a 
time, you can issue a <CR> to use a default 
location for the buffer, which EWVOL then 
displays. If you specified a start address, you 
must specify an end address viien prompted for it; 
otherwise just type <C3^>. 

After EWVOL displays the "Done I" message, you can 
use DB (if you are running online), or the 
Mnemonic Debugger (if you are running offline) to 
look at the contents of the record that you have 
read, in the location the program displayed for 
the buffer. 

Usage: RWVOL 
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SALT ~ SALT finds all uncatalogued pennanent 
objects in a volume. It uses or creates a 
directory ORPHANS in the root of the volume and 
enters the names of all objects not catalogued 
elsevvhere. Uncatalogued directories are found 
first, so no redundancy occurs. SACT will catalog 
the OS paging file vAiich should not be deleted, 
but simply uncatalogued. Only use SALT if you 
have full ACL rights. 

Usage: SALT [ -V | -VERIFY ] [ volume_pathname ] 

The options are: 

-V verify only; don't catalog any orphans 

-VERIFY 

SIOLOGIN — SIOLOGIN listens to an sio line, 
invokes the login sequence and if the login is 
successful, runs the program, prog. If prog is 
not specified, /con\/sh is invoked. Dev_name is the 
sio device descriptor pathname and must be 
specified. Options, if specified, must precede 
the prog and its arguments. 

SIOLOGIN is most useful in conjunction with 
SIOMONIT. 

Usage: SIOLOGIN dev_name [ [-DIALIN] [-N name] 
prog [ args...]] 

Options : 

-DIALIN The sio line connection is remote. If 
the line is a dialup, SIOLOGIN asks for 
an access password before invoking the 
login sequence. The access password is 
a single string read from 
^node_data/siologin_access. Also for 
ronote lines, SIOLOGIN waits for 
carrier detect and hangs up after the 
invoked program returns. If the 
connection is local, sio login waits for 
a cr before beginning the login 
sequence. SIOLOGIN logs invalid 
logins in ^node_data/siologin^og. 

-N name specifies the name to give the process. 
(Takes precedence over the cpo option -n 
when sio login is cpo'd directly instead 
of through siomonit.) 

SIOMDNIT ~ SIOMDNIT allows repeated logins over 
sio lines, independent of login/logout activity 
at the node ke^tooard. The file, filename, 
contains argument lists to be passed to 
invocations of sio login (see the description of 
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siologin for more information) . A maximum of 
three argument lists (one per sio line) are 
processed. SIOMONIT must be cpo'd from the DM's 
startup file ( ^node_data/startup or 
/sys/dn\/startup) to enable the logins to work. 

Usage: SIO^DNIT filename 

Each argument list in the file must have the form: 

[-Repeat] siologin_arg_list 
where: 

-R[epeat] means re- invoke this process 

when it returns. 
siologin_arg_list is an siologin argument list 

of the form: 

dev_pathname [ [-dialin] [-n procname] 
prog [ args ...]] 

For each argument list, siomonit invokes: 

/coiri/siologin siologin_arg_list 

Arguments are passed to siologin uninspected. If 
a pgm_$invoke fails, it is ranoved from the 
list. If a process returns from its first 
invocation within 15 seconds or if it returns 
from subsequent invocations within 15 seconds, it 
is removed from the list. Comments nay be 
included in the file and must begin with 
Siomonit writes a log of its problems in 
^node_data/siomonit_log . 

This program idles, waiting for a fault vdien it 
has no processes left to wait for or repeat. 
Receiving a 'stop' fault causes it to exit; a 
'quit' fault causes it to resume from the 
beginning. (If not idling, quit fault acts like 
stop fault) . If siologin processes fail to stay 
up, check both siologin_log and siomonit_log , 
correct the problan(s) and issue 'sigp siomonit' 
to begin again. Use 'sigp siomonit -stop' to kill 
siomonit . 

XMT — Examines magtape. This program is 

interactive and will print out a list of possible 

commands that can be executed if help if typed 

once the program has been entered. 

Usage: XOT 
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A-1 ASCII CHARACTER SET 



Oct h^ 



Oct jaex 



dec Oct hsK 



00 


00 


NUL 


00 


60 


30 





48 


140 


60 




96 


01 


01 


SOH 


01 


61 


31 


1 


49 


141 


61 


a 


97 


02 


02 


STX 


02 


62 


32 


2 


50 


142 


62 


b 


98 


03 


03 


ETX 


03 


63 


33 


3 


51 


143 


63 


c 


99 


04 


04 


EOT 


04 


64 


34 


4 


52 


144 


64 


d 


100 


05 


05 


ENQ 


05 


65 


35 


5 


53 


145 


65 


e 


101 


06 


06 


ACK 


06 


66 


36 


6 


54 


146 


66 


f 


102 


07 


07 


BEL 


07 


67 


37 


7 


55 


147 


67 


g 


103 


10 


08 


BS 


08 


70 


38 


8 


56 


150 


68 


h 


104 


11 


09 


HT 


09 


71 


39 


9 


57 


151 


69 


i 


105 


12 


OA NL(LF) 


10 


72 


3A 




58 


152 


6A 


J 


106 


13 


OB 


VT 


11 


73 


3B 


7 


59 


153 


6B 


k 


107 


14 


OC 


FF 


12 


74 


3C 


< 


60 


154 


6C 


1 


108 


15 


OD 


CR 


13 


75 


3D 


= 


61 


155 


6D 


m 


109 


16 


OE 


RRS 


14 


76 


3E 


> 


62 


156 


6E 


n 


110 


17 


OF 


BRS 


15 


77 


3F 


9 


63 


157 


6F 


O 


111 


20 


10 


RCP 


16 


100 


40 




64 


160 


70 


P 


112 


21 


11 


XON 


17 


101 


41 


A 


65 


161 


71 


q 


113 


22 


12 


HLF 


18 


102 


42 


B 


66 


162 


72 


r 


114 


23 


13 


XOFF 


19 


103 


43 


C 


67 


163 


73 


s 


115 


24 


14 


HLR 


20 


104 


44 


D 


68 


164 


74 


t 


116 


25 


15 


NAK 


21 


105 


45 


E 


69 


165 


75 


u 


117 


26 


16 


SYN 


22 


106 


46 


F 


70 


166 


76 


V 


118 


27 


17 


ETB 


23 


107 


47 


G 


71 


167 


77 


w 


119 


30 


18 


CAN 


24 


110 


48 


H 


72 


170 


78 


X 


120 


31 


19 


EM 


25 


111 


49 


I 


73 


171 


79 


Y 


121 


32 


lA 


SUB 


26 


112 


4A 


J 


74 


172 


7A 


z 


122 


33 


IB 


ESC 


27 


113 


4B 


K 


75 


173 


7B 


{ 


123 


34 


IC 


FS 


28 


114 


4C 


L 


76 


174 


7C 


1 


124 


35 


ID 


GS 


29 


115 


4D 


M 


77 


175 


7D 


} 


125 


36 


IE 


RS 


30 


116 


4E 


N 


78 


176 


7E 




126 


37 


IF 


US 


31 


117 


4F 





79 


177 


7F 


DEL 


127 


40 


20 


SP 


32 


120 


50 


P 


80 










41 


21 


I 


33 


121 


51 


Q 


81 










42 


22 


" 


34 


122 


52 


R 


82 










43 


23 


# 


45 


123 


53 


S 


83 










44 


24 


$ 


36 


124 


54 


T 


84 










45 


25 


% 


37 


125 


55 


U 


85 










46 


26 


& 


38 


126 


56 


V 


86 










47 


27 


' 


39 


127 


57 


W 


87 










50 


28 


( 


40 


130 


58 


X 


88 










51 


29 


) 


41 


131 


59 


Y 


89 










52 


2A 


* 


42 


132 


5A 


Z 


90 










53 


2B 


+ 


43 


133 


5B 


[ 


91 










54 


2C 


^ 


44 


134 


5C 


\ 


92 










55 


2D 


- 


45 


135 


5D 


] 


93 










56 


2E 




46 


136 


5E 




94 










57 


2F 


/ 


47 


137 


5F 


- 


95 
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impend 


LX A 



B-1 POWERS OF IWO 



2**n 




n 


hex 




1 







1 




2 


1 




2 




4 


2 




4 




8 


3 




8 




16 


4 




10 




32 


5 




20 




64 


6 




40 




128 


7 




80 




256 


8 




100 




512 


9 




200 


1 


024 


10 




400 


2 


048 


11 




800 


4 


096 


12 




1000 


8 


192 


13 




2000 


16 


384 


14 




4000 


32 


768 


15 




8000 


65 


536 


16 




1 0000 


131 


072 


17 




2 0000 


262 


144 


18 




4 0000 


524 


288 


19 




8 0000 


1 048 


576 


20 




10 0000 


2 097 


152 


21 




20 0000 


4 194 304 


22 




40 0000 


8 388 608 


23 




80 0000 


16 777 


216 


24 




100 0000 


33 554 


432 


25 




200 0000 


67 108 


864 


26 




400 0000 


134 217 


728 


27 




800 0000 


268 435 


456 


28 




1000 0000 


536 870 


912 


29 




2000 0000 


1 073 741 


824 


30 




4000 0000 


2 147 483 


648 


31 




8000 0000 


4 294 967 


296 


32 


1 


0000 0000 


8 589 934 


592 


33 


2 


0000 0000 


17 179 869 184 


34 


4 


0000 0000 


34 359 738 368 


35 


8 0000 0000 


68 719 476 


736 


36 


10 0000 0000 


137 438 953 


472 


37 


20 


0000 0000 


274 877 906 


944 


38 


40 


0000 0000 


549 755 813 


888 


39 


80 


0000 0000 


1 099 511 627 


776 


40 


100 


0000 0000 


2 199 023 255 


552 


41 


200 


0000 0000 


4 398 046 511 


104 


42 


400 


0000 0000 


8 796 093 022 208 


43 


800 


0000 0000 


17 592 186 044 


416 


44 


1000 


0000 0000 


35 184 372 088 


832 


45 


2000 


0000 0000 


70 368 744 177 664 


46 


4000 


0000 0000 


140 737 488 355 328 


47 


8000 


0000 0000 


281 474 976 710 656 


48 


1 0000 


0000 0000 
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Appendix B 



/SYSTEST/SSRJUTIL, 8-12 



-A- 

Account Header, 5-11 

Accjount Record, 5-11 

acct_$header in 
acct.ins.pas, 5-11 

acct_$record_t in 
acct.ins.pas, 5-11 

ACL Entry, 5-2 

ACL Header Record, 5-1 

ACL Record, 5-1 

acl_$entry in acl.ins.pas, 5-2 

acl_$hdr in acls.pvt.pas, 5-1 

aci_$rep in acls.pvt.pas, 5-1 

ACLS STRUCTURE, 5-1 

ACL Header Record, 5-1 
ACL Record, 5-1 
ACL Entry, 5-2 

ACTIVE SEGMEOT TABLE, 1-2 

ACTIVE SEGMENT TABLE HEADER, 1-3 

ADDRESS SPACE, 2-1, 7-1 
DN300, 2-1 
DN4xx and DN600, 2-2 
Physical Address Space, 7-1 
Virtual memory, 7-2 

ADDRESSING MODES, 2-3 

AEGIS, 1-1 

AEGIS ERROR CODES, 4-1 

AEGIS SYSTEM RELATIONSHIPS, 1-1 

Apollo I Ke^iDoard - Map, 6-16 

/^llo I Keiix)ard Chart - 
Physical, 6-17 

^^llo I Ke^iDoard Chart - 
Translated (user mode) , 6-18 

Apollo II Keyboard - Map, 6-19 

i^llo II Keyboard Chart - 
Physical, 6-20 

Apollo II Ke^iDoard Chart - 
Translated (user mode) , 6-21 

ASSEMBLER LANSUAGE SUMMARY, 7-3 
Program format, 7-3 
Statanent Syntax, 7-3 
Expression Syntax, 7-4 
Op Codes, 7-4 
Pseudo-ops , 7-5 
Usage Information, 7-7 
Conditional Assembly 
Pseudo-ops, 7-8 

aste t in vm. ins. pas, 1-2 



BAT, 5-2 

batjDlk in vol. ins. pas, 5-2 
bat_hdr_t in vol. ins. pas, 5-3 
blk_hdr_t in base.spo.bbas, 5-7 
BLOCK AVAILABILITY TABLE 

(BAT) , 5-2 
BLOCK AVAILABILITY TABLE 

HEADER, 5-3 
BLT REGISTERS, 3-8 

DN300, 3-8 

DN4XX, 3-8 

DN600, 3-9 
BOOT ERRORS (PROM) , 4-31 
BOOT SHELL COMMANDS, 1-4 



CACHE, 2-3 

CALLING SEQUENCE, 7-8 

Channel Control Block, 6-22 

CLOCK, 1-5 

CLOCK, 2-4 

clock_t in base. ins. pas, 1-5 2-4 

Command Line Syntax (conditional 

processing) , 7-9 
CONDITION CODES, 2-5 
Conditional Assembly 

Pseudo-ops, 7-8 
CONDITIONAL PROCESSING, 7-9 

Command Line Syntax, 7-9 

Syntax Restrictions, 7-9 

SCTiantics, 7-10 
CONDITIONAL TESTS, 2-6 
CONFIGURATION, 2-7 

DN300, 2-7 

DN4xx and DN600, 2-8 
CPU AND MEMORY, 2-1 
CRASH ANALYSIS, 8-9 



DB (MACHINE LEVEL DEBUGGER) , 8-3 

Lights Program, 8-4 
db_$ecb_j:ec in 

/us/debug/db.debug$.ins.pas, 7-11 
DCSR, 3-4 
dcte. t in io. ins. pas, 1-5 
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DEBUG ODMMAND EXTENSIONS, 8-1 
New Commands, 8-1 
Options to CXirrent 
Coranends, 8-1 
Definitions, PEB, 6-25 
DEVICE ADDRESSES (PIO) , 6-1 
DIAGNDSTIC ERROR CODES, 4-31 
dir_entry_t in name. pvt. pas, 5-4 
dir_t in name .pvt. pas, 5-3 
dir_t in name .pvt .pas, 5-5 
Directory Entry, 5-4 
Directory Entry Block, 5-5 
Directory Header, 5-5 
Directory Info Block, 5-4 
Directory Overview, 5-3 
DIRECTORY STRUCTURE, 5-3 

Directory Overview, 5-3 
Directory Info Block, 5-4 
Directory Entry, 5-4 
Directory Entry Block, 5-5 
Directory Header, 5-5 
Notes on directories, 5-6 
DISK BLOCK HEADER. 5-7 
DISK OOMTROLLER TABLE ENTRY, 1-5 
DISK PARAMETERS, 6-1 
DISK VOLUME TABLE EtTTRY, 1-6 
DISK/VOLUME FORMAT, 5-8 
DISPLAY BOARD JUMPERS, 3-1 
DN4XX, 3-1 
DN600, 3-2 
DISPLAY CONTROL AND STATUS 
REGISTER (DCSR) , 3-4 
DN300, 3-4 
DN4XX, 3-5 
DN600, 3-6 
DISPLAY HAREWARE, 3-1 
DMA Control/Status 
Registers, 6-45 
DMA CONTROLLER (DN300 ONLY) , 6-4 
DN300, address space, 2-1 
BLT registers, 3-8 
configuration, 2-7 
display control and status 

reg, 3-4 
exception error stack 
frame, 2-9 
floppy controller, 6-8 
MMU Status Register, 2-20 
PID/PRIV Register, 2-20 
RingA>isk 6-29, 



DN4xx, BLT registers, 3-8 

display board juirpers, 3-1 
display control and status 
reg, 3-5 
DN4xx and DN600, address 
space, 2-2 

Bus Status Register, 2-21 
Clear MMU Status, 2-21 
configuration, 2-8 
CPU A Control Register, 2-21 
Enable CPU B Register, 2-22 
exception error stack 

frame, 2-11 
floj^y controller, 6-12 
MMU Status Register, 2-21 
PID/PRIV Register, 2-20 
RingA>isk, 6-33 
DN600, display board jumpers, 3-2 
BLT registers, 3-9 
display control and status 
reg, 3-6 
Double Precision Floating Point 

Format, 2-13 
dvte_t in disk .pvt .pas, 1-6 



-E- 



Early ACK Field, 1-16 

ECB, 7-11 

ecnode_t of base. in. pas, 1-6 

ENTRY CONTROL BLOCK (ECB) , 7-11 

entry_block_t in 
name. pvt. pas, 5-5 

ERROR CODES AND MESSAGES, 4-1 
AEGIS ERROR CODES, 4-1 
BOOT ERRORS (PROM) , 4-31 
DIAGNOSTIC ERROR CODES, 4-31 
MNEMONIC DEBUGGER ERROR 

CODES (PROM), 4-32 
SYSBOOT ERROR CODES, 4-33 

EVENT COUNT, 1-6 

eventcount_t of base. ins. pas, 1-6 

EXCEPTION ERROR STACK FRAME, 2-9 
DN300, 2-9 
DN4xx and DN600, 2-11 

EXCEPTION TYPES, 2-11 

EXCEPTION VECTORS, 2-12 

Expression Assembler Syntax, 7-4 
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FAULT DIAGNOSTIC REODRD, 1-7 
fault_$bus_info_t in 
fault. ins .pas, 2-11 
fault_$diag_t in 

fault. ins. pas, 1-7 
FILE MAP, 5-9 
FILE SYSTEM, 5-1 
FILENAME SUFFIXES, 7-12 
FLOATING POIMT FORMAT, 2-13 
Single Precision Floating 

Point Format, 2-13 
Double Precision Floating 
Point Format, 2-13 
FLOPPY OONTROLLER, 6-8 
DN300, 6-8 
DN4xx and DN600, 6-12 

-H- 

Header Registry Record, 5-10 



-I- 



I/O MAP, 6-14 
I/O MAP ALLOCATION, 6-15 
infoblk_hdr_t in 
name. pvt. pas, 5-4 
INSERT FILES, 

acct.ins.pas, 5-11 

acl.ins.pas, 5-2 

acls.pvt.pas, 5-1 

base. ins. pas, 1-5, 2-4, 5-14 
5-23 

base.spo.bbas, 2-14, 2-22, 
5-7 

disk. pvt .pas, 1-6 

ecnode_t of base. in. pas, 1-6 

eventcount t of 
base. ins. pas, 1-6 

fault. ins. pas, 1-7, 2-11 

io. ins. pas, 1-5 

ramap.bbvt.bbas, 2-22 

mmap.pvt.pas, 1-9 

name .pvt. pas, 5-3 to 5-5 

ppo.ins.pas, 5-10 



procl.pas, 1-12 
rgy.ins.pas, 5-12 
sbase.ins.pas, 5-13 
vm. ins .pas, 1-2, 1-8, 1-11 
vol. ins. pas, 5-2, 5-3, 5-17, 
5-19, 5-20 to 5-22 
10 MAP, 2-14 

-K- 

KEYBOARD, 6-16 

Apollo I Keiix)ard - Map, 6-16 
Apollo I Ke^tioard Chart - 

Physical, 6-17 
Apollo I Keyboard Chart - 

Translated (user mode) , 6-18 
Apollo II Keyboard - Map, 6-19 
^llo II Keyboard Chart - 

Physical, 6-20 
i^llo II Keyboard Chart - 

Translated (user mode) , 6-21 

-L- 

Lights Program, 8-4 
lv_label_t in vol. ins. pas, 5-17 



MACHINE LEVEL DEBUGGER, 8-3 
MAGTAPE CONTROLLER, 6-22 

System Configuration Pointer 

(at XXXFF6) , 6-22 
System Configuration Block, 

6-22 
Channel Control Block, 6-22 
Parameter Block, 6-23 
MAPPED SEGMENT TABLE (MgT) , 1-8 
MCSR Control (Write-Only) , 2-15 
MCSR Status Register (Read-Only) , 

2-15 
MEMORY BOARD JUMPERS POli DN4XX 

AND DN600 , 2-16 
Memory Control Register, 2-14 
MEMORY CONTROL/STAIUS REGISTERS 
(MCSR) FOR DN300, 2-14 

Menory Control Register, 2-14 
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Memory Status Register, 2-14 
MEMORY CONTROL/STATUS REGISTERS 
(MCSR) FOR DN4XX AND DN600 , 2-15 

MCSR Control (Write-Only) , 

2-15 
MCSR Status Register 
(Read-only), 2-15 
MEMORY MANAGEMENT UNIT 
(MMU), 2-19 

DN300 PID/PRIV Register, 2-20 
DN300 MMU Status Register, 

2-20 
DN4xx and DN600 PID/PRIV 

Register, 2-20 
DN4XX and DN600 CPU A Control 

Register , 2-21 
DN4XX and DN600 MMU Status 

Register, 2-21 
DN4xx and DN600 Clear MMU 

Status, 2-21 
DN4XX and DN600 Bus Status 

Register, 2-21 
DN4XX and DN600 Enable CPU B 
Register, 2-22 
MEMORY MAP (MMAP) , 1-9 
MEMORY MAP ENTRY (MMAPE) , 1-9 
Monory Status Register, 2-14 
Message Data, 1-17 
Message Header, 1-14 
MMAP, 1-9 
MMAPE, 1-9 

inraape in nmap.pvt.pas, 1-9 
MNEMONIC DEBUGGER, 8-5 
MNEMONIC DEBUGGER ERROR CODES 

(PROM) , 4-32 
MMU. 2-19 
MST, 1-8 

mste in vm. ins, pas, 1-8 
MULTIBUS DEVICE ADDRESSES, 6-25 

-N- 

New debug Ccxnmands, 8-1 
Notes on directories, 5-6 



-P- 

PAGE FRAME TABLE E^qTRY 

(PFTE), 2-22 
PAGE MAP, 1-11 
PAGE TRANSLATION TABLE EWTRY 

(PTTE), 2-22 
PAGING SYSTEM, 1-11 
Parameter Block, 6-23 
PASCAL EXTENSIONS, 7-13 
PATHNAME SYNTAX, 7-13 
PCB, 1-12 
PEB, 6-25 

Definitions, 6-25 

KB Control Register Bits, 
6-26 

Useful Combinations, 6-26 

PEB Status Register Bits, 
6-26 

PEB CcHtimands, 6-26 
PEB Comnands, 6-26 
PEB Control Register Bits, 6-26 
PEB Status Register Bits, 6-26 
PERIPHERAL I/O, 6-1 
PFTE, 2-22 

pfte in mraap.bbvt.bbas, 2-22 
Physical Address Space, 7-1 
PIO, 6-1 

pmape in vm. ins. pas, 1-11 
pga_t in base.spo.bbas, 2-14, 

2-22 
PPO Record, 5-10 

K»_$header_t in ppo.ins.pas, 5-10 
FPO_$record_t in ppo.ins.pas, 5-10 
procl t in procl.pas, 1-12 
PROCESS GCMTROL BLOCK (PCB) , 1-12 
PROCESSES, 1-13 

Program format, assanbler, 7-3 
PROGRAMMING INFORMATION, 7-1 
PRDM, 4-31 

Pseudo-ops, assembler, 7-5 
PTTE, 2-22 
pv_label_t in vol. ins. pas, 5-19 

-R- 



Op (Assembler) Codes, 7-4 
Options to Current Debug 

Commands, 8-1 
OS MAPPING, 1-10 



RECORD TYPES, 

acct_$header in acct.inS.pas, 

5-11 
acct_$record_t in 

acct.inS.pas, 5-11 
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acli.$entry in acl.ins.pas, 

5-2 
acl_$hdr in acls.pvt.pas, 5-1 
acl_$rep in acls.pvt.pas, 5-1 
aste^t in vm. ins. pas, 1-2 
batjDlk in vol. ins. pas, 5-2 
batjidr_t in vol. ins. pas, 5-3 
blkjidr_t in base.spo.bbas, 

5-7 
clock_t in base. ins. pas, 1-5, 

2-4 
dcte_t in io. ins. pas, 1-5 
dir_entry_t in name. pvt. pas, 

5-4 
dir_t in naine.pvt.pas, 5-3 
dir_t in name. pvt. pas, 5-5 
dvte_t in disk. pvt. pas, 1-6 
ecnode_t of base. in. pas, 1-6 
entry_block_t in name. pvt. pas, 

5-5 
eventcount^t of base. ins. pas, 

1-6 
fault_$bus_info_t in 

fault. ins. pas, 2-11 
fault_$diag_t in 

fault. ins. pas, 1-7 
infoblkJidr_t in 

name. pvt. pas, 5-4 
lv_J.abeX_t in vol. ins. pas, 

5-17 
mmape in imap.pvt.pas, 1-9 
mste in vm, ins. pas, 1-8 
pfte in irmap.bbvt.bbas, 2-22 
pmape in vm. ins. pas, 1-11 
pprL_t in base.spo.bbas, 2-14, 

2-22 
ppo_$header_t in ppo.ins.pas, 

5-10 
ppo_$record_t in ppo.ins.pas, 

5-10 
procl t in procl.pas, 1-12 
pv_Jabel_t in vol. ins. pas, 

5-19 
rgy_$registry_t in 

rgy.ins.pas, 5-12 
stream_$hdr_rec_t in 

sbase.ins.pas, 5-13 
uid_t in base. ins. pas, 5-14 
vtocjDlk_t in vol. ins. pas, 

5-20 
vtocjtape in vol. ins. pas, 

5-22 



vtoce in vol. ins. pas, 5-21 
vtoceJidr_t in vol. ins. pas, 

5-21, 5-22 
vtocx_t in base. ins. pas, 5-23 

REGISTER SET, 2-23 

REGISTRY FORMAT, 5-10 
Header Record, 5-10 
PPO Record, 5-10 
Account Header, 5-11 
Account Record, 5-11 
Registry Record, 5-12 

Registry Record, 5-12 

RESOURCE LOCK, 1-17 

rgy_$registry_t in rgy.ins.pas, 
5-12 

RING PACKET FORMAT, 1-14 
Message Header, 1-14 
Type Field, 1-15 
Early ACK Field, 1-16 
Message Data, 1-17 

RINGA>ISK, 6-29 

DN300 Ring/t)isk, 6-29 
DN4xx and DN600 RingA>isk, 

6-33 
DMA Control/Status Registers, 
6-45 



Semantics, 7-10 

SERIAL I/O INTERFACE FOR DN300, 

6-48 
SERIAL I/O INTERFACE FOR DN4XX 

AND DN600, 6-56 

SIO Write Control/Status 
Registers, 6-57 
SIO Read Control/Status 
Registers , 6-59 
Single Precision Floating Point 

Format, 2-13 
SIO Read Control/Status 

Registers, 6-59 
SIO Write Control/Status 

Registers, 6-57 
STACK FRAME, 1-18 
STACK FRAME, 7-15 
Statement Syntax, Assembler, 7-3 
STATUS WORD, 1-18 
STATUS WORD, 7-15 
STREAM FILE HEADER. 5-13 
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streaitL_$hdr_rec_t in 

sbase.ins.pas, 5-13 
Syntax Restrictions, Assembler, 

7-9 
SYSBOOT EHOR ODDES, 4-33 
System Configuration Block, 6-22 
Systan Configuration Pointer 

(at XXXFF6) , 6-22 
SYSTEM DEBUGGING, 8-1 
SYSTEM DIRECTORIES, 1-19 
SYSTEM DUMPS, 8-10 

-T- 

TIMERS, 6-60 
TOUCHPAD, 6-60 
TRKP CODES, 1-19 
Type Field, 1-15 

-U- 

UID Hash Algorithm, 5-14 
ui6_t in base. ins. pas, 5-14 
UIDS ~ System, 5-15 



UID Hash Algorithm, 5-14 
UIDS ~ Syston, 5-15 
UNIQUE IDENTIFIER (UID), 5-14 
Usage Infonnation, Assembler, 

7-7 
Useful lEB Combinations, 6-26 



-V- 

Virtual memory, 7-2 
VOLUME LABEL ~ LOGICAL, 5-17 
VOLUME LABEL ~ PHYSICAL, 5-19 
VTOC BLOCK, 5-20 
VTOC ENTRY, 5-21 
VTC)C HEADER. 5-22 
VTOC INDEX, 5-23 
VTOC MAP ENTRY, 5-22 
vtocjDlk_t in vol. ins. pas, 5-20 
vtoc_jnape in vol. ins. pas, 5-22 
vtoce in vol. ins. pas, 5-21 
vtoce_hdr_t in vol. ins. pas, 5-21, 

5-22 
vtocx_t in base. ins. pas, 5-23 



APOLLO CONFIDENTIAL. INTERNAL USE ONLY. 



index-6 



REftDER'S RESPONSE 

i^llo Ccmputer uses readers* comments in revising and inproving 
our documents. 

Document Title: Apollo DOMAIN Engineering Handbook 
Document Revision: 01 
Order Number: 002398 

What is the best feature of this manual? 



Please list any errors, omissions, or problem areas in the manual. 
(Identify errors by page, section, figure, or table number wherever 
possible.) 



What type of user are you? 

Systems programmer; language 

implications programmer; language . 

Apollo SSR 

How often do you use the i^llo system? _ 

Nature of your work on the i^llo system: 



Organization 



Street Address 



City State Zip/Country 
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